Review and improve aligning to: { Target audience: {Address decision makers only. They are responsible for technology success, governance, security, and/or operational standards across the organization and responsible for ensuring the success all developer/workload teams. Do not address details related to developers, individual workload design, or implementing the standards.}
Style-agent: {Apply content style rules:
- Do not include meta-commentary or implementation notes.
- Keep tone authoritative but advisory, guiding decision-making rather than commanding.
- Avoid:
- Em dashes.
- Emotional or marketing language.
- Using semicolons.
- Avoid gerunds (verbal nouns ending in -ing) at the beginning of sentences.
- Replace:
- Gerunds with active verbs.
- Future tense with present tense.
- Passive voice with active voice.
- “Leverage” with “use.”
- Add:
- Clear noun referents after demonstrative pronouns.
- Ensure:
- Sentence case for all headers.
- Simple sentence structures.
- Images support and align with guidance.
- Narrative flow is smooth and connected.
- Preserve all existing links. }
Accuracy-agent: {Review the technical accuracy of the article against https://learn.microsoft.com/ and update the guidance where needed.}
Format: {For each ## header: [use Imperative recommendation that's relevant for decision makers (short yet meaningful)] [1 sentence: define important terms and/or explain the context of this guidance for decision makers. state implicitly why decision makers using Microsoft/Azure services should care enough to read through it]. Recommendation: [1 sentence: Overarching recommendation that all decision makers must consider framed in way so that the following numbered paragraph serve as a checklist for acting on this recommendation]. To apply this recommendation, use the following checklist: [The following numbered bullet points should be a checklist for decision makers to use]
For each body paragraph, [use sequential numbered lists starting at 1]. [Add a short topic imperative recommendation action phrase as an inline header in bold for decision makers]. [define the topic or terms to provide necessary context for the decision makers]. Best practices: [Explain the proven best practices successful decision makers Microsoft have used. Explain any options or choices within those best practices decision makers need to make to tailor the best practices to their situation] Decision guidance: "Decide …" or "Choose …" (choose best start depending on context) [Explain the options or choices that decisions makers must make within those best practices just listed, state when to choose each option, and state tradeoffs for choosing each option. Ensure this doesn't conflict with the best practices, but rather helps decision makers choose the best way to apply the best practices.]}
Style: {Use simple language. Don't use dependent clauses. Don't use comma-separated lists of 3 or more items or phrases. But make sure it reads and flows together. Use the active voice. Keep the same structure. Make sure all the sections and articles flow together and are logically sequential.} }
guidance to review and improve: {