Confluence Architecture Overview Page for Non-Specialists
Explain a system design in plain language for mixed readers.
The Open buttons send the prompt text as currently shown below to that site only when you click. Fill in the placeholders first.
[VERIFY] is an editorial flag, not a blank to fill. Wherever the prompt shows [VERIFY], check that item against a reliable source before you use it.
Write an architecture overview page for Confluence. System description from the engineers: [SYSTEM_NOTES]. Readers: [READERS]. Key components: [COMPONENTS]. Important decisions and trade-offs: [TRADE_OFFS]. Constraints: [CONSTRAINTS]. Write for readers who are not engineers, in layers. The top layer is a short paragraph a manager could read in 30 seconds. The second is the component tour, one paragraph each, plus what the system does for users. The third, for curious readers, covers the main trade-offs and why, and the limits of the system. Use an everyday comparison once only if it genuinely clarifies, and label it as a comparison. Explain each technical term on first use and add a glossary. Describe how data moves as a numbered flow in which every step says what goes in, what comes out and who or what does the work. List failure cases in the form: if this fails, users notice this, and we do that. Describe any diagram as a list of boxes and arrows instead of claiming to produce one, say which diagrams to keep updated and who owns each. Do not invent components. Where the notes disagree, show both versions and ask which is right. Keep security details to the level suitable for the readers and tell me which details belong on a restricted page [VERIFY]. Finish with a one-paragraph note on what the page deliberately does not cover, a Further reading section with link placeholders, a contact line for the engineering owner, and questions the engineers should answer to check the explanation.
Fill in before use
Optional: type your details and the prompt above updates. Nothing is saved or sent.
Replace each bracketed placeholder with your own details, then paste into Any AI or another assistant.