mdolab / mdolab/niceplots

Improve documentation

Open
#19 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation good first issue
Dominant language
Python
Stars
28
Forks
15
PR merge metrics
No merged PRs in 30d

Description

Description of feature

Potential solution

  • fix some docstrings (e.g. math rendering etc.) and sphinx linking to other functions
  • add a bit more text to explain the examples, or make them more uniform
  • move some of the installation notes from the README to the RST files

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the README and the RST files, then inspect the docstrings and rendered examples for math formatting and Sphinx links. Identify the specific documentation gaps and inconsistencies before editing. Done means the installation notes are in the RST documentation, examples have clearer and more uniform explanations, and documented links and math render correctly.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.