Code snippets question

[ERyan71258]

If adding a code snippet via an external file, does it become an additional element and must it be listed as such in an Additional Elements annex?

[palemieux]

Snippets are edited as separate documents (on the file system) but inserted in the main prose element at rendering time, i.e. they are not published as separate documents. Snippets are just editorial sugar, and therefore not additional elements.

[ERyan71258]

Thanks. Then editors will not get wrapped around whether or not to list them. "Editorial sugar" - that is a new one. I will have to remember it.

…

On Sat, Jul 8, 2023 at 12:41 PM Pierre-Anthony Lemieux < ***@***.***> wrote: Snippets are edited as separate documents (on the file system) but inserted in the main prose element at rendering time, i.e. they are not published as separate documents. Snippets are just editorial sugar, and therefore not additional elements. — Reply to this email directly, view it on GitHub <#146 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/A4KXDEGVTTQU34X5T3QVY5TXPGEVPANCNFSM6AAAAAA2CKYJJY> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[palemieux]

@ERyan71258 Can you review the proposed clarification at #147 ? Thanks!

[ERyan71258]

Will changes be tracked in code snippets in a similar manner as changes tracked in the main text?

[palemieux]

Will changes be tracked in code snippets in a similar manner as changes tracked in the main text?

Yes. The snippet get merged into the text by the tooling, before the redline is generated.

[ERyan71258]

Thanks.