Tool Build Standards
Mandatory structure, linking rules, and QA checks for every new Visuwire tool page.
Tool Build Standards
These standards are mandatory for all new tool pages in /content/tools/.
Required Page Structure
Every tool page must contain the following sections:
- Primary Query
- Tool Purpose
- Inputs
- Output
- How To Use
- Required Internal Links
- Related Pages
Internal Linking Minimums
Each tool page must include at least:
- 3 links to company pages under
/companies/ - 2 links to comparison pages under
/comparisons/ - 2 links to glossary pages under
/glossary/
Topical Authority Rules
- One canonical query per tool page.
- No duplicate tools for near-identical intents.
- Use entity-first language in headings and intro text.
- Update
lastmodwhenever core formulas or benchmark data changes. - Include at least 2 contextual links to relevant sector or tool pages.
Publish QA Checklist
- Run the tool-page validator:
cd /home/richardmoser/Documents/visuwire/visu-wire-hugo && python3 pipeline/validate_tool_pages.py
- Run Hugo build check:
cd /home/richardmoser/Documents/visuwire/visu-wire-hugo && hugo --minify
- Verify links render correctly and no orphan tool pages exist.