Documentation setup thoughts about brevitas

[Giuseppe5]

We need to commit them because they are automatically picked up by GitHub to generate the documentation website.

I know that there are alternatives to this approach and maybe we'll switch in the future but I wouldn't say it's a priority at the moment

[Giuseppe5]

I believe we have a similar setup, with the HTML files in the doc folder being automatically generated starting from the .rst files in the docsrc folder.

[V0XNIHILI]

Ah right, I didnt see that, thanks! Maybe it would be better not to commit the HTML files though, because now both the source and the generated files are commited: so every time one file changes, another one changes too and it contains the same information. For example, whenever I was searching through the code base for some things, I found references in many HTML files, but those files are hard to read in a text editor.