Skip to main content
Ctrl+K

Documenteer

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

Section Navigation

  • Rubin user guide features

First steps

  • Setting up the Documenteer configuration for Rubin user guides
  • Organizing content in a Rubin user guide

Advanced configuration

  • Configuring Python projects in documenteer.toml
  • Embedding a Redoc subsite for OpenAPI (HTTP API) documentation
  • Using the rst epilog for common links and substitutions
  • Redirecting pages when reorganizing content
  • The “Help improve” page footer
  • Extending conf.py directly

Design features

  • Diagrams as code
  • Badges
  • Tab sets
  • Embedded videos

Markdown & Jupyter Notebooks

  • Using Markdown syntax in Rubin Observatory documentation
  • Including Jupyter notebooks in documentation

Reference

  • documenteer.toml reference
  • The documenteer.conf.guide configuration preset
  • User guides
  • The “Help improve” page footer

The “Help improve” page footer#

Every page in a user guide ends with a “Help improve this page” box, just below the previous/next page links. The box gathers the page’s improvement and provenance information in one place:

  • An “Edit this page on GitHub” link that opens the page’s source file in GitHub’s editor, resolved by the documenteer.ext.githubeditlink extension.

  • A “This page was last modified on…” timestamp derived from the page’s Git commit history by the documenteer.ext.lastmodified extension, localized to the reader’s timezone.

Site-wide configuration#

Each item is controlled by a setting in documenteer.toml:

  • sphinx.show_github_edit_link toggles the edit link (default true).

  • sphinx.show_last_updated toggles the timestamp (default true).

When both are disabled — or neither applies to a page, as on generated pages like the search page — the box is omitted entirely.

Hiding the box on individual pages#

Some pages don’t benefit from the box; a site’s home page, for example, often has a curated layout where the box would be a distraction. Set the hide_content_footer file-wide metadata field to suppress the box on a single page.

In a reStructuredText file, add a field list at the very top of the file, before the title:

index.rst#
:hide_content_footer:

My homepage
===========

In a Markdown (MyST) file, use YAML front matter:

index.md#
---
hide_content_footer: true
---

# My homepage

The rest of the site is unaffected; only pages carrying the field hide the box.

Printed pages and PDF output#

The box is interactive chrome, so it is omitted from printed output along with the rest of the page navigation — a link to GitHub’s editor isn’t actionable on paper. In its place, printed pages end with a print-only provenance footer carrying the metadata that still matters in a fixed document: the “last modified” timestamp and the page’s canonical URL.

The hide_content_footer metadata field suppresses the print footer along with the box.

This page was last modified on 2026-08-07.

https://documenteer.lsst.io/guides/improve-this-page.html

previous

Redirecting pages when reorganizing content

next

Extending conf.py directly

Help improve this page

Found a mistake or something missing? Edit this page on GitHub.

This page was last modified on 2026-08-07.

On this page
  • Site-wide configuration
  • Hiding the box on individual pages
  • Printed pages and PDF output

Rubin Observatory

  • For scientists
  • News

Documentation

data.lsst.cloud

Community forum

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

The U.S. National Science Foundation (NSF) and the U.S. Department of Energy (DOE) Office of Science will support Rubin Observatory in its operations phase to carry out the Legacy Survey of Space and Time. They will also provide support for scientific research with the data. During operations, NSF funding is managed by the Association of Universities for Research in Astronomy (AURA) under a cooperative agreement with NSF, and DOE funding is managed by SLAC National Accelerator Laboratory (SLAC), under contract by DOE. Rubin Observatory is operated by NSF NOIRLab and SLAC.

NSF is an independent federal agency created by Congress in 1950 to promote the progress of science. NSF supports basic research and people to create knowledge that transforms the future.

The DOE Office of Science is the single largest supporter of basic research in the physical sciences in the United States and is working to address some of the most pressing challenges of our time.

Logos of the Vera C. Rubin Observatory, NSF, US DOE, NOIRLab, AURA, and SLAC.