http://idk.i2p/lb-docs/live-manual/style-guide.en.html
An example is, after all, just an example. 957 It is often better to use a line that only applies to a specific case than using abstractions that may confuse your readers. In this case you can provide a brief explanation of the effects of the proposed example. 958 There may be some exceptions when the example suggests using some potentially dangerous commands that, if misused, may cause data loss or other similar undesirable effects.