Routing, Navigation & Structural Integrity
This document defines the non-negotiable structural rules governing URLs, pages, menus, redirects, and system routes on PenOdyssey.com.
These rules exist to preserve editorial clarity, security stability, SEO consistency, and long-term maintainability.
When in doubt, follow the canon.
I. Slug & Routing Integrity
No WordPress Page may share a slug with a Custom Post Type archive, taxonomy base, or plugin-defined endpoint. Ever.
Slug collisions create ambiguity at the routing and firewall level, often surfacing as 403 Forbidden errors, blocked redirects, or security false positives.
Pages are editorial destinations. System routes are plumbing. They must never overlap.
Approved Patterns
- Editorial hubs:
/all-books/,/press-center/ - Namespaced taxonomies:
/book-author/{term},/book-series/{term}
Prohibited Patterns
- Pages named
books,authors,series - Any Page slug identical to a CPT archive, taxonomy base, or plugin endpoint
Fix collisions by renaming the Page, never the system route.
II. Menu Destination Integrity
Menus must point to intentional editorial destinations, not raw system routes.
Menus are promises to readers. Every destination must be human-intentional, stable under security and caching, and canonical.
Approved Menu Targets
- Editorial Pages
- Individual taxonomy terms (e.g.,
/book-author/john-elcik/)
Prohibited Menu Targets
- Custom Post Type archive roots (e.g.,
/books/) - Bare taxonomy bases (e.g.,
/book-author/) - Plugin-defined utility or structural endpoints
If a destination feels automatic, it does not belong in a menu.
III. Redirect Integrity
Redirects are corrective tools, not structural dependencies.
Redirects exist to preserve legacy links and signal canonical changes. They must never be required for navigation or discovery.
Approved Uses
- Old slug to new canonical slug
- Retired page to curated replacement
- Legacy URLs blocked by security (server-level redirects)
Prohibited Uses
- Menu items pointing to redirected URLs
- Redirects used to mask slug collisions
- Redirect chains (A → B → C)
Enforcement test: If a redirect disappeared tomorrow and something broke, the structure—not the redirect—is wrong.
IV. Security-Aware URL Design
Pen Odyssey operates with layered security and caching. Certain URL patterns trigger protection automatically.
Avoid Slugs That Resemble
- Enumeration paths
- Directory roots
- Asset containers
Examples to Avoid
/books//files//media//downloads/
Preferred Alternatives
all-xyzxyz-hubxyz-overview
If security blocks a URL, redesign the route—do not weaken the firewall.
V. Pre-Publish & Pre-Rename Checklist
Slug Ownership
- Does not match a CPT archive
- Does not match a taxonomy base
- Does not match a plugin endpoint
Editorial Intent
- Reader-facing destination → Page
- System structure → CPT or taxonomy
Menu Safety
- Menu item points to final destination
- Destination works logged out and incognito
- No redirect required to function
Redirect Hygiene
- Old slugs redirected intentionally
- Redirects are single-hop (301)
- Redirects are not used as architecture
VI. Canonical Principle
Pen Odyssey favors clarity over cleverness, intention over automation, and editorial control over default behavior.
When uncertain:
- Rename the Page
- Create a hub
- Avoid raw system paths
Silence from security tools is success.
