Skip to content

Update the documentation guide within the development guide - #1156

Merged
namurphy merged 139 commits into
PlasmaPy:mainfrom
namurphy:doc-guide-update
Jul 25, 2021
Merged

namurphy merged 139 commits into
PlasmaPy:mainfrom
namurphy:doc-guide-update

Conversation

@namurphy

@namurphy namurphy commented May 28, 2021 •

Copy link
Copy Markdown
Member

The goal of this PR is to expand the documentation within our development guide on how to write documentation in order to make it more complete and accessible to new contributors. This is in preparation for Plasma Hack Week.

Here's an incomplete list of things I'm planning. I'll probably edit this list as we go.

  • Introduce ReST, including examples
  • Briefly introduce Markdown
  • Introduce Sphinx
  • Discuss the numpydoc standard
  • Add an example docstring with links, references, math, etc.
  • Discuss ReST substitutions (should merge Set up ReST substitutions for docs #1147 first, and then incorporate it into here)
  • Mention plasmapy_sphinx and create an issue on adding more information on it to the documentation guide
  • Update the description of how to build documentation

@github-actions github-actions Bot added the docs PlasmaPy Docs at http://docs.plasmapy.org label May 28, 2021
@codecov

codecov Bot commented May 28, 2021 •

Copy link
Copy Markdown

Codecov Report

❗ No coverage uploaded for pull request base (main@6e9eb4e). Click here to learn what that means.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #1156   +/-   ##
=======================================
  Coverage        ?   96.98%           
=======================================
  Files           ?       71           
  Lines           ?     7026           
  Branches        ?        0           
=======================================
  Hits            ?     6814           
  Misses          ?      212           
  Partials        ?        0           

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 6e9eb4e...8a998e1. Read the comment docs.

Comment thread docs/development/doc_guide.rst Outdated
Comment thread docs/development/doc_guide.rst Outdated
Co-authored-by: Erik Everson <[email protected]>
Comment thread docs/development/doc_guide.rst Outdated
@namurphy

namurphy commented Jun 3, 2021 •

Copy link
Copy Markdown
Member Author

@namurphy
namurphy enabled auto-merge (squash) July 22, 2021 19:52
@namurphy
namurphy requested a review from rocco8773 July 22, 2021 21:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contributor guide docs PlasmaPy Docs at http://docs.plasmapy.org

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants