Shoulder

Rotator cuff problems

Specimen page — the live version is written for two readers at once, a referred patient and a referring GP.

Specimen page. The text below describes what a finished page would carry — it is not clinical information and has not been reviewed by a clinician.

A simplified editorial illustration of the shoulder joint

About this page

This is a specimen page on a fictional demonstration website. It carries no clinical information of any kind, and nothing on it has been written or checked by a clinician.

The condition named above is real, and a real practice's site would describe it here. This one does not, because that description would need sign-off from a qualified reviewer before it could be published anywhere a patient might read it — and on a demonstration site there is nobody to give it. Rather than fill the space with text that looks clinical and is not, the page shows its own structure at full length instead.

What the finished page carries here

The shoulder pages differ from the hip and knee ones in a way worth showing: the referral pattern is broader, so the live copy is written for two readers at once — a patient who has been referred and a GP deciding whether to refer. The finished page carries both without splitting into two documents.

That is the argument this whole site is making. The information architecture does the work that separate microsites usually do badly: one page, one URL, two audiences, with the referrer material reachable but never in the patient's way.

The clinical description that would sit in this section has not been written, and will not be until there is somebody qualified to sign it off.

How this page is put together

This page and 12 others are rendered from one template driving three separate content collections — conditions, treatments and articles. Nothing about the layout below is specific to conditions; the same file produces the referrer articles and the treatment pages, and it took the third collection without a change to the component.

The contents list beside this text is generated from the section headings on this page, so it cannot fall out of step with them. On a wide screen it stays with you as you scroll; on a narrow one it collapses above the text in document order, which is also the order a screen reader meets it in.

The 2 related links below are checked when the site is built. A link pointing at an entry that does not exist stops the build with the offending id named, so a broken cross-reference is a failure the developer sees rather than one a reader finds.

This website does not provide medical advice. It is a design demonstration, not a source of clinical information.