2 minute readReference note
How should a reference hub connect a broad explanation with detailed evidence?
In brief
A useful hub lets someone understand the subject, choose the relevant detail and reach the underlying evidence. Its organizing principle is the reader’s problem, rather than a target number of supporting pages.
Use the overview to explain the scope, important distinctions and routes into the subject. Give separate pages to tasks that need their own examples, methods or current information. An explanation of a capability can link to implementation details, a specific case study, product limits and research without repeating each resource in full.
Make the connections contextual. A claim about a completed project should lead to that project, while a statement about present availability should lead to the current offer. Descriptive links help readers understand why the destination matters. Pages should also explain their relationship back to the broader subject so an arrival deep inside the site is not a dead end. An award needs its issuer, year and specific recognition. A historical project can demonstrate experience without establishing current availability or representative performance.
Build around existing evidence navigation where it works. Avoid several overview pages competing to explain the same subject, and avoid forcing unrelated material into a cluster. Review the hub when a source changes or disappears; a polished summary with broken or obsolete support is an unfinished reference.