Skip to content
Snippets Groups Projects

Refactor and Improve Documentation

Merged Frederik Hennig requested to merge fhennig/documentation-update into v2.0-dev

This MR contributes various refactorings and improvements to the Sphinx documentation of pystencils.

  • Delete doc subfolder containing the old documentation tree
  • Introduce sphinx-design elements for more pleasing visuals
  • Create a welcome page with general information about the project
  • Start constructing a comprehensive reference guide and API reference
  • Use sphinx.ext.autosummary where appropriate to declutter API listings into several subpages
  • Set the build-documentation CI task to fail when errors occur during sphinx-build
  • Fix various reference errors in docstrings throughout the project
  • Started writing a migration guide for downstream code from 1.3.x. to 2.0

This MR exclusively touches documentation files and docstrings. When reviewing, it might be sensible to focus on the generated doc pages available in the pipeline artifacts.

There is still a lot of work to do to bring the documentation up to standards; this set of changes is by no means complete.

Edited by Frederik Hennig

Merge request reports

Loading
Loading

Activity

Filter activity
  • Approvals
  • Assignees & reviewers
  • Comments (from bots)
  • Comments (from users)
  • Commits & branches
  • Edits
  • Labels
  • Lock status
  • Mentions
  • Merge request status
  • Tracking
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
Please register or sign in to reply