- Notifications
You must be signed in to change notification settings - Fork11
Gatsby: Python packages source, intersphinx source#269
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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Open
tony wants to merge86 commits intomasterChoose a base branch fromgatsby-docs
base:master
Could not load branches
Branch not found:{{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline, and old review comments may become outdated.
Uh oh!
There was an error while loading.Please reload this page.
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
for rst in **/*.rst; do pandoc "$rst" -f rst -t gfm -o "${rst%.*}.md"; donepoetry remove --dev doc8 alagitpull docutils sphinx-issues sphinx
poetry add mkapi --dev --python ">=3.7" -E docs
poetry add mkdocs --dev --python ">=3.5" -E docspoetry add mkdocs-material --dev --python ">=3.5" -E docs
poetry add sphinx-issues --dev --extras docs --optionalpoetry add alagitpull --dev --extras docs --optional --allow-prereleases
…numpy format (#267)- Move sphinx format to Numpy-style- Move from reStructuredText to Markdown (via recommonmark). The master plan is to eliminate docutils and sphinx as a bottleneck completely in favor of something else (e.g. gatsby with a source that inspects our modules and can source intersphinx)- Move from RTD to GitHub Action, full support of poetry extras packages, deploys straight to S3 and CloudFront
codecovbot commentedAug 7, 2020 • edited
Loading Uh oh!
There was an error while loading.Please reload this page.
edited
Uh oh!
There was an error while loading.Please reload this page.
Codecov Report
@@ Coverage Diff @@## master #269 +/- ##==========================================- Coverage 85.57% 84.84% -0.73%========================================== Files 16 16 Lines 804 805 +1 ==========================================- Hits 688 683 -5- Misses 116 122 +6
Continue to review full report at Codecov.
|
5354b23 toeffff43Comparecf9f3ef to410e041Compare7f69eab toc480bb4CompareSign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading.Please reload this page.
Eliminate dependency on docutils and sphinx. These are great projects, but they not friendly
to configure on and focused primarily toward internal code API documentation.
Today - markdown is more commonplace and supports extensions better than docutils does
and static site generators offer better inter-document linking than sphinx. For instance, gatsby
supports intuitive, structured, comprehensive, detailed, typed and recursive sources in graphql,
rather than the visitor pattern offered by docutils.
mkdocs, pdoc(3), and even non python documentation generators have a legitimate stakehold
in making documentation portable.
Other sphinx projects (e.g. flask, standard library python) can still be linked to intersphinx
Python package source
https://github.com/readthedocs/sphinx-autoapi +https://github.com/PyCQA/astroid
Generate gatsby source by parsing a package into a JSON / YAML structure
then into GraphQL
Intersphinx source
https://sphobjinv.readthedocs.io/en/latest/index.html
Parse objects.inv on projects into gatsby graphql source
MDX utilities to link to intersphinx sources
MDX utilities to link to python package sources