CDCgov / CDCgov/PyRenew

Have edit links for dynamically-generated documentation pages point to their source files

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

Nobody has claimed this yet.

documentation
Dominant language
Python
Stars
29
Forks
9
Avg merge
9d 9h
Merged PRs (30d)
8

Description

This is possible. See for example here:

https://github.com/vispy/vispy/blob/6855a9c6ab1058e290d7bdfdce83551c5b18c343/doc/conf.py#L138-L180

It will eliminate the need for placeholder files and associated hooks.

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 documentation configuration, using the linked vispy doc/conf.py example as a reference for dynamically generated pages. Identify how PyRenew currently creates edit links and placeholder files; done means links point to the generating source files and the placeholder files and associated hooks are no longer needed.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.