1. Define the document’s identity
Record its title, purpose, audience, language and scope. Include edition or validity information where the organization uses it. Upload date is not automatically an approved document version. Ask the content owner which detail identifies the correct edition.
In the exercise, the resource is Installation instructions for model A, English edition 2. Add another language and an older English edition. Can someone distinguish them without opening the files? If not, the presentation needs more precise information.
2. Decide what a stable link means
A link might refer to a specific historical edition or to the presentation of the current resource. Agree the required behavior before replacing files. Previous project documentation may need exactly the edition used at the time.
Check what the CMS actually does when a file is replaced: changes its address, overwrites content or creates a new file. Do not infer behavior from the filename. Test in preview with a separate known copy for the exercise.
| Field | What the visitor needs to know | Check |
|---|---|---|
| Title | Which document this is | Distinct from similar files |
| Language | Which version they can read | Matches the content |
| Edition | Which version applies | Approved by the content owner |
| Link | What is downloaded | Tested from the published page |
3. Describe the file beside the download
Use link text such as Model A installation instructions, edition 2, PDF. State size when known and language where it could be unclear. Format and size need to match the file actually delivered.
Information needed to choose the document should also be available on the webpage. A download button should not be the only explanation of the resource. Check that the link can be reached and understood with a keyboard.
4. Rehearse the complete replacement
Publish a marked test edition in a safe environment. Follow links from the collection, related pages and other languages. Download the file and inspect its content rather than checking only the server response. Look for old edition names in cards and descriptions.
Ask another person to find the correct edition and record the result. Decide how old documents are labeled, archived or withdrawn and who approves that decision. Changing an address also requires a considered response for previous links.