DOC: Monte carlo documentation updates

[Gui-FernandesBR]

Pull request type

• ReadMe, Docs and GitHub updates

Checklist

• Tests for the changes have been added (not needed)
• Docs have been reviewed and added / updated
• Lint (black rocketpy/ tests/) has passed locally
• All tests (pytest tests -m slow --runslow) have passed locally
• CHANGELOG.md has been updated (if relevant)

Current behavior

The MonteCarlo class is ready to be deployed but there is still a room to improve its documentation and examples.

New behavior

See the commit history one by one.
To keep in mind:

• Don't "over document" the code, only leave # this is a comment when it is really necessary or helps to organize.
• All the class and methods docstrings were reviewed
• Some TODOs were added to the code, as I saw some improvements opportunities but didn't want to fix them in this same PR.
• I created a new .rst totally dedicated to explain how to use the Stochastic classes. I think this will make lives easier when reading the monte carlo example notebook.
• Some stuff don't even make sense in the code (e.g. varying the number of grains of a motor???). But we can remove/improve it in the next minor release.

Important: There is something broken with the Environment class when integrating with NOAAs data server. I cannot not solve it immediately. If you want to build the documentation locally, please comment the examples that use GFS or GEFS environment model.

Breaking change

• No

Additional information

Still needs to accomplish:

• Finish the StochasticModel review
• Finish all other Stochastic classes reviews.
• Double check the jupyter notebooks

Make no mistake, updating docstrings is not an easy task. I think we should release the next version using the "as-is" state, and keep improving the documentation based on users feedbacks.

[codecov]

Codecov Report

Attention: Patch coverage is 64.81481% with 19 lines in your changes are missing coverage. Please review.

Project coverage is 73.60%. Comparing base (eeb4df8) to head (cd1def5).
Report is 1 commits behind head on develop.

Files	Patch %	Lines
rocketpy/simulation/monte_carlo.py	13.33%	13 Missing ⚠️
rocketpy/stochastic/stochastic_model.py	87.50%	4 Missing ⚠️
rocketpy/plots/monte_carlo_plots.py	60.00%	2 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #607      +/-   ##
===========================================
+ Coverage    73.58%   73.60%   +0.01%     
===========================================
  Files           70       70              
  Lines        10313    10289      -24     
===========================================
- Hits          7589     7573      -16     
+ Misses        2724     2716       -8     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[Gui-FernandesBR]

Here you can see a preview:

[phmbressan]

Outstanding work @Gui-FernandesBR! I read through everything and most of the comments I had were similar to the ones made by Stano.

Sorry if my review seems lacking in comments given the size of the PR, but I believe the work here is rather solid, specially the page on Stochastic objects.

[Gui-FernandesBR]

@phmbressan @MateusStano the last commit cf24129 polished a few TODO messages (they are less "aggressive" now).

I think it is ready to be merged. Can you approve please?