[Suggestion] Prefix source files with their listing number from the book

[codenius]

What could be improved?

Prefixing source code filenames would make it easier to follow along with the contents of the book when trying to spot a source file mentioned. Also it would enable sorting the source files in file managers according to the actual flow of the lecture. As a bonus i would offer a convenient shortcut for auto complete in the terminal.

Do you have a suggestion on how to improve it?

Introducing a naming convention for directories too would only be consequent.

Complete example with running index in order of initial appearance in the book as directory name prefix
Listing1 objects/OBC_TypeFunctions.cpp becomes 1_objects/1_OBC_TypeFunctions.cpp

Accompanying files that are not source code could just share the prefix number with the source file they belong to. If used for multiple listing there could be multiple solutions for this, the simplest probably being to just prefix these with the first listing number they appear in.
Find and replace could be used to update filename references in the book.

[Lyannen258]

Thank you for this detailed suggestion.

The core hurdle we face with this approach is the fluid nature of the book's composition. Since sections are often moved, added, or revised extensively, implementing sequential numbering would require recreating that ordering across all file names every time we reorganize content. The maintenance cost of keeping the numbering synchronized is too high.

That said, the current system presents the full directory path (e.g. objects/OBC_TypeFunctions.cpp) specifically to allow users to copy and paste that exact path into the terminal, providing an equally efficient shortcut as envisioned in your suggestion.

Alternatively, if you are using VS Code with the sources folder open, you can press Ctrl+P/⌘+P to open the Quick Open dialog and paste the full path there for quick access, thus eliminating the need to manually search for a source file in the file explorer.