Re-merging intranet.neuro.polymtl.ca <-> neuro.polymtl.ca

[kousu]

I think we should keep all the docs in a single repo. The only reason the old dokuwiki content was split to two repos (https://github.com/neuropoly/neuropoly-docs/ and https://github.com/neuropoly/neuropoly-internal-docs/) was because the table of contents that generated got too deep. But if we accept #21 then we have much more control over the table of contents than we do with Gitbook.

I would take all the .md files currently in https://github.com/neuropoly/neuropoly-internal-docs/ and put them in a subfolder called '/lab-manual' nin this repo.

But:

Originally posted by @jcohenadad in #21 (comment)

About merging the internal lab and external lab website: i'm still not 100% sure if we should do it. What would be the pros/cons, etc. I see how it could be confusing for external people visiting our lab website (ie: many entries in the TOC, overwhelming, etc.)

I still think we can tame this. We can use a custom sidebar template. https://sphinx-book-theme.readthedocs.io/en/latest/customize/sidebar-primary.html#control-the-left-sidebar-items gives an example: under /blog their sidebar gets special formatting for blog posts; we could use the same to have pages under /lab-manual start the table of contents at itself, and making sure to set :maxdepth: 3 to prevent the primary ToC from spiraling.

[kousu]

Leaving this wide open for reflection and comments from the lab!