Skip to main content

How to Use a Google Writing Style Guide to Write Performing Articles

· 2 min read
Wisdom Nwokocha
Wisdom Nwokocha
Senior Technical Writer | Documentation Engineer | Developer Advocate | Android Engineer

Technical writing steps

Writing compelling and Google-friendly content is essential. The Google developer documentation style guide provides invaluable insights and guidelines to help you achieve this goal.

Follow these steps to harness the power of the style guide and craft stellar articles that captivate your audience.

Want to write clear, concise, and Google-approved content? Look no further than the Google developer documentation style guide!

Step 1: Identify your content type​

The first step is to understand the type of content you're creating. Is it a blog post, technical documentation, user guide, or something else?

Each type may have slightly different formatting and style considerations.

Step 2: Break down your content​

Once you understand the content type, identify specific areas where you might need guidance. For example, are you including:

  • Lists of items
  • Code snippets
  • Technical terms
  • Definitions

Step 3: Consult the Google writing style guide​

Head over to the Google developer documentation style guide: https://developers.google.com/style. Navigate through the relevant sections based on your identified content areas.

Step 4: Find specific recommendations​

For instance, if you're writing a list, search for "lists" in the guide. You'll find helpful insights on:

  • Formatting: Bullet points vs. numbered lists
  • Punctuation: Commas or semicolons after list items
  • Clarity: Ensuring each item is clear and concise

Step 5: Apply & adapt​

Based on the guide's recommendations, adapt your content to adhere to the suggested formatting and style. Remember, adapt the guidance to your specific content and context.

Step 6: Proofread & refine​

Finally, proofread your content thoroughly, ensuring consistency with the style guide's recommendations and your own unique voice.

By following these steps and leveraging the Google writing style guide, you can create polished, informative, and Google-friendly content!