Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: touch up manuals, enable fail-on-warning for docs #4416

Merged
merged 4 commits into from
Oct 12, 2023

Conversation

matzf
Copy link
Contributor

@matzf matzf commented Oct 10, 2023

  • add missing documentation for remote_interface_id in topology.json for peering links (fix-up for Peering links continued #4390)
  • fix duplicate envvar documentation in router.rst and control.rst (envvars can only have one definition in rst), and expand the description (fix-up for doc: update timestamp spec #4300). Consistent formatting for envvar documentation.
  • fix references in SPAO doc
  • enable fail-on-warning for read-the-docs builds: this makes PR fail the the read-the-docs check if there are build warnings. Also enable the same build flags in the Makefile for local documentation builds.

This change is Reviewable

Fix duplicate envvar documentation (envvars can only have one definition
in rst), and expand the description. Consistent formatting for envvar
documentation.
Move the description of the duration string format to the common
section, as it's referenced by multiple components (currently control
service and router).

Fix reference to spao.
We want clean builds without warnings.
Enable fail on warning in the readthedocs pipeline and in local builds.
Copy link
Contributor

@FR4NK-W FR4NK-W left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:lgtm:

Reviewed 7 of 7 files at r1, all commit messages.
Reviewable status: :shipit: complete! all files reviewed, all discussions resolved (waiting on @matzf)

@matzf matzf merged commit 2ea2d89 into scionproto:master Oct 12, 2023
4 checks passed
@matzf matzf deleted the doc-manual-fixes branch October 12, 2023 11:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants