Skip to content

Update redirects README to reflect current behavior. - #6593

Merged
nick-nlb merged 2 commits into
datacommonsorg:masterfrom
nick-nlb:redirect-readme-copy
Aug 18, 2026
Merged

nick-nlb merged 2 commits into
datacommonsorg:masterfrom
nick-nlb:redirect-readme-copy

Conversation

@nick-nlb

Copy link
Copy Markdown
Contributor

Description

The README.md in server/routes/redirects/README.md that describes how to update redirect mapping is incorrect/out-of-date.

While the description of how to update the mapping (via the gcloud storage cp) is correct, the description of when those changes are picked up by production is not.

The file states that production reads this redirect mapping on each redirection call, resulting in the immediate pickup of these changes. This is incorrect. The bucket is read when the Flask server starts (in __init__.py).

This PR updates the README.md to correct the description.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request corrects misleading documentation regarding how redirect mappings are processed by the server. By clarifying that the configuration is read during initialization, it ensures that team members understand the necessity of a deployment cycle for applying changes to redirects.

Highlights

  • Documentation Accuracy: Updated the README to correctly reflect that redirect mapping changes are loaded at server startup rather than on every request.
  • Operational Clarity: Clarified that a server rollout or restart is required for redirect updates to take effect in production.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request updates the documentation in server/routes/redirects/README.md to clarify that the redirects.json file is read by the Flask server on startup, meaning a rollout or restart is required for any changes to take effect in production. There are no review comments, so I have no feedback to provide.

@nick-nlb
nick-nlb requested a review from gmechali August 18, 2026 18:40
The `redirects.json` file in this directory is stored in a GCS bucket and
read by the production Flask server on each redirection call (to achieve
immediate update without rollout/restart).
read by the Flask server on server start. A rollout/restart is required

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I remember now - I may have changed the behavior.

this used to always read from GCS which felt extremely wasteful. So changed it so that it loads on startup. I just didnt fix this documentation :)

Thank you!

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The new behavior is much better, especially given how rarely we actually change these redirects!

@nick-nlb
nick-nlb merged commit a73e31f into datacommonsorg:master Aug 18, 2026
18 checks passed
clincoln8 pushed a commit to clincoln8/datcom-website that referenced this pull request Aug 19, 2026
…6593)

## Description

The README.md in `server/routes/redirects/README.md` that describes how
to update redirect mapping is incorrect/out-of-date.

While the description of how to update the mapping (via the `gcloud
storage cp`) is correct, the description of when those changes are
picked up by production is not.

The file states that production reads this redirect mapping on each
redirection call, resulting in the immediate pickup of these changes.
This is incorrect. The bucket is read when the Flask server starts (in
`__init__.py`).

This PR updates the README.md to correct the description.
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