Docs :: Extract Specific Lines from Examples

[Valazan]

Description

We often need to showcase specific parts of our code in the documentation. I propose a feature that allows us to specify line ranges in our executable code files and automatically include these lines in our documentation examples.

Expected Behavior

• Ability to specify a line range (e.g., lines 10-32) or specific comments (e.g. //snippet1) when embedding markdown files
• The specified line range should be automatically extracted and included in the documentation as an example.
• If the source code updates, the snippets have to reflects the changes

[pierobassa]

Examples should have the entire life cycle though and not only snippets

[nwbrettski]

We should also ensure that the entire code block is provided at the end of the file as a link.

[nwbrettski]

[Valazan]

Doing this task as part of #650