Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Sphinx vs mkdocs?

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

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Quiet
Tech stack
python
Domain
documentation

Research direction

Start by reading the linked aind-software-docs standards page, then inspect this template's current Sphinx documentation setup and how its default is selected. Compare that setup with the stated MkDocs recommendation and record which standard the template should follow; the issue is done when the choice and resulting template direction are clearly documented.

Written by the indexing model from the issue text.

Description

aind-software-docs recommends using mkdocs, should the template conform to that instead of defaulting to sphinx docs?

Dominant language
Jinja
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

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.

More from AllenNeuralDynamics/python-templates

All issues in AllenNeuralDynamics/python-templates

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.