Skip to content
This repository was archived by the owner on Oct 14, 2023. It is now read-only.

API Docs Update #491

Merged
merged 21 commits into from
Dec 28, 2018
Merged

API Docs Update #491

merged 21 commits into from
Dec 28, 2018

Conversation

jorgepiloto
Copy link
Member

@jorgepiloto jorgepiloto commented Nov 11, 2018

This pull request has as an objective updating all the API documentation of poliastro project, including:

  • Menu based on modules
  • Latex Formulas, to see clearly equations behind the functions
  • Examples, so users can check the power of poliastro
  • More references and notes

Formatting edits by @Juanlu001

@astrojuanlu
Copy link
Member

Thanks a lot for the pull request @IngenieroDeAviones! There are some minor PEP8 failures, you can check them by clicking the Circle CI report:

https://circleci.com/gh/poliastro/poliastro/1006

Also, is this finished or do you intend to add more commits to it?

@jorgepiloto
Copy link
Member Author

The idea is to keep adding more commits, at least one per module for poliastro.core and the high-level API

@codecov
Copy link

codecov bot commented Nov 12, 2018

Codecov Report

Merging #491 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##           master     #491   +/-   ##
=======================================
  Coverage   86.04%   86.04%           
=======================================
  Files          49       49           
  Lines        2186     2186           
  Branches      166      166           
=======================================
  Hits         1881     1881           
  Misses        265      265           
  Partials       40       40
Impacted Files Coverage Δ
src/poliastro/core/perturbations.py 100% <ø> (ø) ⬆️
src/poliastro/core/hyper.py 100% <ø> (ø) ⬆️
src/poliastro/core/iod.py 74.85% <ø> (ø) ⬆️
src/poliastro/core/stumpff.py 100% <ø> (ø) ⬆️
src/poliastro/core/elements.py 92.15% <ø> (ø) ⬆️
src/poliastro/core/propagation.py 86.04% <ø> (ø) ⬆️
src/poliastro/core/util.py 92.3% <ø> (ø) ⬆️
src/poliastro/core/angles.py 98.29% <ø> (ø) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update ff437dc...4e71827. Read the comment docs.

@astrojuanlu
Copy link
Member

The test failures now are because of the doctests, for example https://circleci.com/gh/poliastro/poliastro/1014

@jorgepiloto
Copy link
Member Author

For the moment, I think this should be enough to give the API Docs a better readable structure. Also, I have introduced some labels on the left-side bar menu to also organize the different topics included on it. Hope you like it 😄

Copy link
Member

@astrojuanlu astrojuanlu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well, that was a long review for a long pull requests! I left lots of comments, hope you don't feel overwhelmed. Some of them are whitespace changes or one letter changes. I also realized some problems that I'd like to manage in future pull requests. Overall, great job!

@@ -37,6 +37,7 @@
'sphinx.ext.intersphinx',
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Talking about extensions: intersphinx inventory has moved: http://matplotlib.org/objects.inv -> https://matplotlib.org/objects.inv.

@@ -0,0 +1,5 @@
Angles
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When I build the documentation locally this page appears empty. Do you know why?

@astrojuanlu
Copy link
Member

The main challenge now will be to rebase it on current master, because after the Black restyling there are lots of merge conflicts. I will lend a hand with that when you're done pushing @IngenieroDeAviones 💪

@jorgepiloto
Copy link
Member Author

I finally added more information on NEOs and also Orbit module. Waiting for your suggestions and code review @Juanlu001 😄

Jorge added 14 commits December 28, 2018 17:39
This commit adds the following features to the core.utils documentation:

[+] Possibility of adding matrix in latex form
[+] Examples of how functions work
This commit includes:

[+] New description for Stumpff Module
This commit includes:

[+] New elements documentation
[+] Latex formulas for core.elements
[+] Several examples for each function of the module
This commit tries to fix pep-8 style of previous commited scripts
A new structure, more readable for users has been applied also with a new folder tree containing the rst files for each module
Improved rst files
Jorge Martinez added 2 commits December 28, 2018 17:40
Added more info about Neos, Iod and Orbit modules
@ghost ghost assigned astrojuanlu Dec 28, 2018
Solve example M_to_nu
Jorge Martinez and others added 3 commits December 28, 2018 19:15
@ghost ghost assigned astrojuanlu Dec 28, 2018
@astrojuanlu astrojuanlu merged commit fee844b into poliastro:master Dec 28, 2018
@ghost ghost removed the 2 - In Progress label Dec 28, 2018
@astrojuanlu
Copy link
Member

Wohooooooo merging! 🎉 It took a while but I was so excited about the results. Great job @IngenieroDeAviones, looking forward to collaborating in the future 😉

@astrojuanlu astrojuanlu removed their assignment Dec 28, 2018
@astrojuanlu astrojuanlu mentioned this pull request Dec 28, 2018
@jorgepiloto jorgepiloto deleted the API_Docs branch January 1, 2019 19:48
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants