Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Creating documentation #61

Merged
merged 23 commits into from
Mar 6, 2024
Merged

Creating documentation #61

merged 23 commits into from
Mar 6, 2024

Conversation

elbeejay
Copy link
Contributor

@elbeejay elbeejay commented Mar 5, 2024

PR to create the documentation for this project and migrate it from readthedocs to GitHub Pages (to close #60).

This largely follows the format we developed for the GOSTurban project, this consistency in documentation strategy should help reduce the maintenance burden in the future.

This PR itself doesn't do a ton for formatting or editing of content, focus was on getting the existing content to execute and render in documentation and connecting up the CI etc. I think future PRs will be needed to clean up and improve the content itself (e.g., #62). I'd suggest we merge this so that the team can easily view the hosted documentation and open up issues, make suggestions, propose revisions, etc.

@elbeejay elbeejay changed the title Creating documentation Standardizing doc-strings and creating documentation Mar 6, 2024
@elbeejay elbeejay changed the title Standardizing doc-strings and creating documentation Creating documentation Mar 6, 2024
@elbeejay elbeejay marked this pull request as ready for review March 6, 2024 01:26
@elbeejay
Copy link
Contributor Author

elbeejay commented Mar 6, 2024

Should also close #22 and will close #1.

This was linked to issues Mar 6, 2024
@elbeejay elbeejay requested a review from g4brielvs March 6, 2024 01:28
@elbeejay
Copy link
Contributor Author

elbeejay commented Mar 6, 2024

For context I think the huge negative diffs are because I had to rename files to remove spaces, and for the .ipynb files I had to clear their outputs and metadata so they build properly as part of the documentation.

@g4brielvs g4brielvs added the documentation Improvements or additions to documentation label Mar 6, 2024
@g4brielvs g4brielvs self-requested a review March 6, 2024 16:42
@g4brielvs g4brielvs merged commit c58fb74 into main Mar 6, 2024
6 checks passed
@g4brielvs g4brielvs deleted the gh-pages-docs branch March 6, 2024 16:48
g4brielvs added a commit that referenced this pull request Mar 6, 2024
* osm_parser doc-strings

* calculate_od_raw doc-strings

* fetch_pois doc-strings

* style network_clean.py

* doc-strings conversion_utils.py

* doc-strings graphtool.py

* doc-strings optimization.py

* doc-strings fetch_od.py

* doc-strings load_osm.py

* doc-strings core.py

* symlink the tutorials dir for docs

* re-org the docs

* readme symlink

* move api docs pages

* update gitignore

* fix symlinks

* add some pre-commit hooks

* reorg for docs

* rename to remove spaces and clean notebook outputs

* more space removal and notebook cleaning

* revisions to toc and tutorial

* Remove auto-generated content from version control

---------

Co-authored-by: Gabriel Stefanini Vicente <gvicente@worldbank.org>
g4brielvs added a commit that referenced this pull request Mar 6, 2024
* osm_parser doc-strings

* calculate_od_raw doc-strings

* fetch_pois doc-strings

* style network_clean.py

* doc-strings conversion_utils.py

* doc-strings graphtool.py

* doc-strings optimization.py

* doc-strings fetch_od.py

* doc-strings load_osm.py

* doc-strings core.py

* symlink the tutorials dir for docs

* re-org the docs

* readme symlink

* move api docs pages

* update gitignore

* fix symlinks

* add some pre-commit hooks

* reorg for docs

* rename to remove spaces and clean notebook outputs

* more space removal and notebook cleaning

* revisions to toc and tutorial

* Remove auto-generated content from version control

---------

Co-authored-by: Gabriel Stefanini Vicente <gvicente@worldbank.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Development

Successfully merging this pull request may close these issues.

Create Documentation GOSTnets documentation won't build Create Documentation
2 participants