Reorganization of documentation sections

[akeeste]

This PR heavily reorganizes the structure of the documentation to condense the top-level table of contents. It also moves the breakdown of Python vs MATLAB features to the lowest level, instead of being visible at the topmost level of the documentation. The actual content of the documentation is largely unchanged, just restructured:

• reorganize API
• reorganize module overviews
• reorganize examples
• add missing example (upcrossing)
• consolidate examples into one table. Adds tags to the table so that users can quickly search for examples that pertain to a certain topic. I wanted to make a table that can be filtered/reduced by tag, but that's not possible solely with reStructuredText
• consolidate online forum sections into the one at the end. This reduces duplication of content

Attaching a bunch of screenshots of the TOC tree so that the build is easier to view:

[simmsa]

@akeeste, overall this looks like a nice reorganization! I think everything looks good. The organization of the Examples section is a nice improvement.

My only questions are with the "Examples" section:

• I like the idea of the tags, but I can't actually see them without scrolling.
  • Maybe we should look into making the page container wider?
  • I will see if I can figure out how to do this.

• We really quickly start using acronyms (WEC, CEC, etc). Do you think we should start off slower? I think this can be scary to new users.

[simmsa]

@akeeste, I figured out a solution to increase the container width of a page (screenshots below), but it it makes all of the documentation pages wider. This is fine for the examples, but other pages with large paragraphs of text become much harder to read. I can probably work to find a solution to only make the examples page wider, but it will take some more digging. Let me know if this an avenue you would like to explore for displaying the examples and I can put it in more effort.

[ssolson]

If you guys decide to adjust the default page margins please check that the modification look good (or at least not any worse) on mobile and has good responsiveness by hitting F12 and dragging the side panel and selecting a phone view from the presets.

[akeeste]

@simmsa @ssolson I think enabling a different page width or allowing lines to wrap once per table block could make that table more readable, given that changes don't affect the mobile view as @ssolson pointed out. The table is pretty long though and can horizontal scroll already. I'd prefer to merge this new reorganization and further improve the formatting in another PR