Skip to content

Conversation

raisuraj2004
Copy link

Description

  • Added running-in-production.md under docs/source/.
  • Updated the index.rst toctree to include the new page.
  • Fixed documentation build warnings caused by missing/misnamed files

This PR fixes #3249

Notes for Reviewers

  • Verified that both Quick Start and Running in Production appear correctly in the docs sidebar.
  • Confirmed that the documentation builds without any warnings or errors.

Signed commits

  • Yes, I signed my commits.

@raisuraj2004
Copy link
Author

The documentation build (readthedocs) passed successfully, which was the main focus of this PR.
The failing Docker/Podman checks appear to be unrelated to the documentation changes made here.

This PR addresses issue #3249 by:

Correcting the running-in-production.md filename and linking it properly in the toctree.
Ensuring the Sphinx docs build without warnings.

@sgoggins
Copy link
Member

sgoggins commented Sep 9, 2025

@raisuraj2004 : There seems to be an error with readthedocs.io:

https://app.readthedocs.org/projects/oss-augur/builds/29503183/

Copy link
Member

@sgoggins sgoggins left a comment

Choose a reason for hiding this comment

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

A few notes.

sphinx-rtd-theme>=2.0,<3

# Extensions
myst-parser>=2.0,<3
Copy link
Member

Choose a reason for hiding this comment

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

I suspect it is the additional imports that are not being supported by readthedocs.io.

@raisuraj2004 raisuraj2004 force-pushed the fix-docs-3249 branch 13 times, most recently from bf5ea20 to 576f6ad Compare September 15, 2025 17:05
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: raisuraj2004 <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: raisuraj2004 <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: raisuraj2004 <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: raisuraj2004 <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: raisuraj2004 <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: raisuraj2004 <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
Signed-off-by: raisuraj2004 <raisuraj1947@gmail.com>
Signed-off-by: SURYA RAI <raisuraj1947@gmail.com>
@raisuraj2004
Copy link
Author

I’ve updated the commits and pushed the latest changes.
@sgoggins Let me know if anything else is needed.

Copy link
Contributor

Choose a reason for hiding this comment

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

since we are already using uv for dependency management, having a requirements.txt seems redundant.

Was it difficult for you to use uv to install what you needed? do the docs need improving in that regard?

with:
python-version: '3.10'
- name: Install doc requirements
run: pip install -r docs/requirements.txt
Copy link
Contributor

Choose a reason for hiding this comment

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

uv is installed in the prior command, using that would probably be better - happy to help get this working if you get stuck!

Copy link
Contributor

@MoralCode MoralCode left a comment

Choose a reason for hiding this comment

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

This PR seems to contain a lot of various fixes to the point that I'm having a hard time identifying which filename was "corrected" per the title of this PR or what specific issue with ReadTheDocs this is intended to resolve.

It seems like this PR's core change is to create a new "running augur in production" document - is that correct?

Make sure to configure the following environment variables:

- `AUGUR_RESET_LOGS`: Determines whether logs should be reset on startup.
- `REFRESH_MATERIALIZED_VIEWS_INTERVAL_IN_DAYS`: Controls how often materialized views are refreshed. (Default: 1 day)
Copy link
Contributor

Choose a reason for hiding this comment

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

This is not an environment variable that exists in augur

Comment on lines -9 to +7
os: ubuntu-22.04 # <- add this line
os: ubuntu-22.04
Copy link
Contributor

Choose a reason for hiding this comment

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

was Generative AI used as part of the creation of this commit?

@MoralCode MoralCode added the more info needed Issues that need additional context and information to be resolved. label Oct 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
more info needed Issues that need additional context and information to be resolved.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update docs for running in production
3 participants