A useful guide is orphaned after a release

What to change

Publication should include an intelligible place in the library. Choose the directory or existing guide that introduces the same reader problem, then add a reference that states why the new article helps. Ask someone unfamiliar with the project to start from the homepage and find it. Their route is better evidence of discoverability than knowing that a developer can paste the URL into a browser.

A worked example

Illustrative example

Illustrative test: Ask a colleague to find the guide through the library using only its subject.

How to check the result

The colleague reaches the article through a sensible path and the link survives rebuilding.

A mistake to avoid

A sitemap entry alone does not make a website easy to browse.

Your action checklist

Use these checks to prepare a discussion with your team or supplier. Tick a check when you have recorded the decision or evidence, rather than when a feature has simply been promised.

Decisions to recordFind the closest topic directory that already serves the intended reader.Add a descriptive link that explains the guide's actual task.Traverse from the homepage without typing the new article address.

Evidence, open questions and decisionsNext action and responsible role

Entries stay in this page and are not submitted to Kay & Co. Download your notes before leaving; the page does not save them.