generated from nginx/template-repository
-
Notifications
You must be signed in to change notification settings - Fork 121
Closed
Remove legacy
/content/nap-waf directory to reduce maintenance overhead and improve AI accuracy#1385Enhancement
Copy link
Labels
🔥 p2Priority 2: Impacts production; non-emergencyPriority 2: Impacts production; non-emergencyproduct/nap-waf
Description
Problem Statement
The /content/nap-waf directory contains legacy documentation for older NGINX App Protect WAF versions (v4 and v5). All relevant content has already been migrated to /content/waf.
Keeping these obsolete files in the repo causes several problems:
- Maintenance Overhead — Contributors must fix broken links and review irrelevant files during PRs, creating unnecessary work.
- AI & Search Confusion — Our AI assistants and search systems index everything in the repo. Including outdated docs risks surfacing obsolete or conflicting information to users.
- Content Governance — Retaining unused docs violates our “delete and archive boldly” principle and reduces clarity around what’s current and trustworthy.
- No Dependency — A redirect from
/nginx-app-protect/to/waf/is already in place, so removing the old content won’t impact users or SEO.
# General redirects
location ~^ /nginx-app-protect/ {
return 301 /waf/;
}Proposed Action
- Remove the entire
/content/nap-wafdirectory from the repo. - Verify that
/content/wafcontains all relevant, updated documentation. - Confirm that no build scripts, navigation files, or indexes still reference
/content/nap-waf. - Test the
/nginx-app-protect/ → /waf/redirect to ensure it functions correctly after removal.
Expected Outcomes
- Cleaner, easier-to-maintain documentation repo.
- Reduced friction in PR reviews and content updates.
- Improved accuracy of AI assistant and search results.
- Stronger alignment with content governance best practices.
Metadata
Metadata
Assignees
Labels
🔥 p2Priority 2: Impacts production; non-emergencyPriority 2: Impacts production; non-emergencyproduct/nap-waf