Show Menu

Writing guidance for Adobe Documentation

These guidelines apply whether you are creating new documentation or updating existing documentation.
Please do the following:
  • Check the spelling and grammar in your articles.
  • Use a friendly tone.
  • Use simple sentences. They are easier to understand and translate into other languages.

Styles guidelines

Keep the following in mind when writing documentation.
  • Write concisely : Don't waste words. Keep sentences short and concise. Keep your article focused. Keep the number of notes to a minimum.
  • Focus on the audience and purpose : Before you begin writing, clearly determine who the customer is and what task he or she is trying to accomplish. Write your article to help that customer do that task.
  • Use examples : Provide examples to explain concepts.
  • Organize your content : Create sections to divide instructions into more manageable groups of steps. Use a screenshot when it adds clarity.