07/05/2021 11:54, Burakov, Anatoly: > On 06-May-21 5:40 PM, Conor Walsh wrote: > > +* ``start-after`` and ``end-before`` can use any text within a given file, > > + however it may be difficult to find unique text within your code to mark > > the > > + start and end of your snippets. In these cases, it is recommended to > > include > > Such lenient attitude still leaves room for accidental changes (e.g. > typo fixes, whitespace reformatting, language fixes etc.). I would've > preferred the scissor syntax to be mandatory for all comment snippets > for documentation. However, risk is pretty low so i can live with that :)
Compiling the documentation is part of any reasonnable test, so the risk is very low. > > + explicit tags in your code to denote these locations for documentation > > purposes. > > + The accepted format for these comments is:
