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.

On this page