Skip to content

SEO Checklist

Mark Drake edited this page Aug 23, 2024 · 1 revision

Title

  • Are you using a brief and descriptive title?
  • Is the title informative?
  • Is the title so long that only a portion is shown in results?
  • Are all the words in your title necessary?
  • Is the title unique enough to be differentiated from similar content?
  • If you need to decide between similar title keywords, investigate which is best with Google Trends
  • Is the URL generated from the tutorial?

Browser Title

  • Consider your Tutorial Title…
    • Can you remove unnecessary words or prepositions?
    • Can you add additional descriptive keywords?

Description

  • Did you put the purpose of the tutorial in the first sentence?
  • Users will only see ~155 characters of description in search results
  • Does this space (or the first paragraph of Tutorial Content) accurately describe and summarize the page’s content?
  • Did you avoid using generic descriptions or filling the Description with mostly keywords?
  • When producing similar content, did you provide unique descriptions for each page?
  • Avoid using markdown in the description

Tutorial Content

  • Are you using descriptive words and synonyms where possible?
  • When porting content, are you varying language and sentence structure?

Images…

  • Do they have a descriptive ALT tag?
  • Do they have a descriptive filename separated by hyphens (e.g. python-environment-debian.png)?
  • Are they optimized for the web? You can use https://tinypng.com/

Links…

  • Are you describing the page you’re linking to in the anchor text?
  • Avoid using generic anchor text like “here” or “article” or the page’s URL
  • Avoid creating unnecessary links

Step-by-step instructions

Keeping readers on the page...

  • Is your text scannable?
  • Are you using bolded keywords when helpful?
  • Do each of your paragraphs have only 1 main idea?
  • Are paragraphs short?

When vetting past tutorials, check for and remove:

  • Duplicate descriptions
  • Broken links
  • Images with missing alt text

Frequently review content to ensure that it is up to date and update the date when you fully review. Updating the date will help the SEO of the article.

Staying up to date on SEO:

If you have any questions or suggestions regarding our Style Guide, please create an issue and we will follow up accordingly.

Clone this wiki locally