<!--
title: Never edit generated JSON
domain: docs
topic: CI/CD
language: Json
source: kamranahmedse/developer-roadmap
updated: 2025-10-19
url: https://awesomereviewers.com/reviewers/developer-roadmap-never-edit-generated-json/
-->

Treat any build/CI-generated JSON (and files under similar “public/…-content” paths) as read-only. Don’t patch them directly in PRs—changes will be overwritten or won’t propagate.

How to apply:
- Find the upstream source used by the generator (e.g., templates, content definitions, or the build script/config).
- Make the change there.
- Regenerate the JSON via the normal pipeline/build step and verify the output.

Example (PR rule of thumb):
- ❌ Commit to: `public/roadmap-content/*.json` (auto-generated output)
- ✅ Commit to: the generator input/template/source, then run the build to update the generated JSON automatically.
