restructured doc folders

[chiamp]

The motivation behind this PR is to organize the doc files so that they are in line with how they are represented in the Flax RTD documentation pages. For example, Flax Sharp Bits is currently under docs/notebooks, but is displayed as under guides in the Flax RTD documentation.

This PR restructures doc folders by doing the following:

• Creates subfolders in docs/guides and docs/examples, and moves all doc files into their corresponding subfolders
• Deletes several notebook files. These are referenced at the very top section of the corresponding guides, but there are discrepancies between them. We either should delete the notebooks (which this PR does) or update the notebook files so that they are consistent with the corresponding RTD doc page. Some examples of doc pages with corresponding notebook files:
  • docs/notebooks/full_eval vs. docs/guides/full_eval
  • docs/notebooks/optax_update_guide vs docs/guides/optax_update_guide
  • docs/notebooks/orbax_upgrade_guide vs docs/guides/orbax_upgrade_guide
  • docs/notebooks/state_params vs docs/guides/state_params
• Renames docs/getting_started to docs/quick_start
• Removed unreferenced docs (See Clean up unreferenced doc pages #3080):
  • docs/guides/jax_for_the_impatient
  • docs/notebooks/linen_intro
  • docs/mission.md
  • docs/overview.md

View docs here.

[codecov-commenter]

Codecov Report

Merging #3434 (a94b6dd) into main (8d09772) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #3434   +/-   ##
=======================================
  Coverage   83.64%   83.64%           
=======================================
  Files          56       56           
  Lines        6800     6800           
=======================================
  Hits         5688     5688           
  Misses       1112     1112           

Files	Coverage Δ
flax/jax_utils.py	44.06% <ø> (ø)
flax/training/checkpoints.py	68.69% <ø> (ø)
flax/traverse_util.py	99.01% <ø> (ø)

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[cgarciae]

When we merge this we will have to add some redirects in RDT so the old URLs still work.

[chiamp]

When we merge this we will have to add some redirects in RDT so the old URLs still work.

Which old URL's were you thinking? I changed the old ones so they point to the new URL's