Skip to main content
Ctrl+K
Logo image Logo image

Documenteer

Site Navigation

  • Rubin user guides
  • Technical notes
  • Sphinx extensions
  • Change Log
  • Development
  • Rubin docs

Site Navigation

  • Rubin user guides
  • Technical notes
  • Sphinx extensions
  • Change Log
  • Development
  • Rubin docs

Section Navigation

Guides

  • Development guide
  • Release procedure

Architecture

  • Theming architecture overview
    • Handling CSS, JavaScript, and image assets
    • Handling Jinja HTML templates

Reference

  • Python API
    • documenteer.conf
      • get_asset_path
      • extend_static_paths_with_asset_extension
      • extend_excludes_for_non_index_source
      • get_template_dir
      • DocumenteerConfig
      • ConfigRoot
      • ProjectModel
      • PythonPackageModel
      • OpenApiDocsModel
      • OpenApiGeneratorModel
      • SphinxModel
      • IntersphinxModel
      • LinkCheckModel
      • ThemeModel
    • documenteer.ext
      • setup
      • generate_openapi_spec
      • setup
      • LsstBibtexStyle
      • jira_bracket_role
      • jira_parens_role
      • jira_role
      • setup
      • lsst_doc_shortlink_role
      • lsst_doc_shortlink_titlecase_display_role
      • lsstio_doc_shortlink_role
      • setup
      • mock_code_ref_role
      • setup
    • documenteer.requestsutils
      • requests_retry_session

DevelopmentΒΆ

Guides

  • Development guide
    • Scope of contributions
    • Environment set up
    • Code formatting and linting with pre-commit
    • Running tests via tox
    • Running tests through pytest
    • Building documentation
    • Updating the change log
    • Style guide
  • Release procedure
    • Regular releases
    • Backport releases

Architecture

  • Theming architecture overview
    • Handling CSS, JavaScript, and image assets
    • Handling Jinja HTML templates

Reference

  • Python API
    • documenteer.conf
    • documenteer.ext
    • documenteer.requestsutils

previous

Change Log

next

Development guide

Edit this page

© Copyright 2015-2022 Association of Universities for Research in Astronomy, Inc. (AURA).

Built with the PyData Sphinx Theme 0.12.0.

Created using Sphinx 8.1.3.