---
title: Potential improvements to docgen
...

This document is meant to outline potential improvements to docgen which might be considered in the future.

# File listings

Embedded files, unlike scenarios, do not get any special treatment at the moment, other than rendering as a code block with some appropriate classes.

It would be nice to provide the following:

1. Line numbering, <https://stackoverflow.com/questions/41306797/html-how-to-add-line-numbers-to-a-source-code-block> has some examples of how
   Importantly they should not interfere when copy/pasting
2. Labels like scenarios have for various attributes of the file including its name perhaps?
3. Syntax highlighting, ideally done without javascript?
