{"meta":{"title":"Making content findable in search","intro":"Follow these SEO best practices to help users find GitHub documentation using search engines.","product":"Contribute to GitHub Docs","breadcrumbs":[{"href":"/en/contributing","title":"Contribute to GitHub Docs"},{"href":"/en/contributing/writing-for-github-docs","title":"Writing for GitHub Docs"},{"href":"/en/contributing/writing-for-github-docs/making-content-findable-in-search","title":"Make content findable"}],"documentType":"article"},"body":"# Making content findable in search\n\nFollow these SEO best practices to help users find GitHub documentation using search engines.\n\n## About search engine optimization (SEO)\n\nSearch engine optimization (SEO) is the practice of earning visibility for web content in search engine results, such as those of Google and Bing. Google search is the top referrer to GitHub Docs and the most common entry point for our users.\n\nWe can plan and write our content to improve SEO. Better SEO improves the experience of people searching for documentation because it makes it more likely for them to find the information they seek using their preferred search terms.\n\n## Best practices for content SEO\n\nGood SEO requires planning content for specific audiences and being attentive to the words they use to search. Follow these best practices to improve an article's SEO.\n\n### Select a target audience\n\nUnderstand and write to the specific audience for the content: developers, administrators, or code learners. This helps you to:\n\n* Use words that your readers use.\n* Make content relevant to their needs and tasks.\n* Provide the right amount of context and background information.\n\n### Respond to search intent\n\nCraft content around **search intent**: the task, question, or problem that drives a member of the target audience to search for information online.\n\n* Conduct search intent research. For example, analyze search engine results pages (SERPs) for relevant queries.\n* Understand user needs. Use multiple sources such as customer feedback, user interviews, and metrics.\n\n### Use clear language\n\nFollow guidance in [Best practices for GitHub Docs](/en/contributing/writing-for-github-docs/best-practices-for-github-docs), including:\n\n* Ensure every article has a clear, discrete topic.\n* Put higher priority content first in an article.\n* Structure articles with clear headings.\n* Edit content for consistency following the [Style guide](/en/contributing/style-guide-and-content-model/style-guide).\n\n### Incorporate keywords\n\nIncorporate keywords, or top search terms used by your audience, into page copy and metadata. For example, if you are writing about \"billing\" but your audience primarily uses \"cost\" and \"payment,\" use those terms instead.\n\nGoogle and Bing both offer keyword research tools to help you discover relevant keywords. The Technical Content team also consults Google Search Console data to understand what search terms lead to pages on GitHub Docs.\n\n### Include metadata\n\nUse complete metadata in the frontmatter. To see the values available, see [Using YAML frontmatter](/en/contributing/writing-for-github-docs/using-yaml-frontmatter).\n\nOn GitHub Docs, the `intro` element displays as an on-page subhead and serves as the HTML metadata description. The article title serves as the HTML page title. For good SEO:\n\n* Write the title and `intro` to be complementary and keyword-rich. Consider how they will render in research.\n* Accompany all images with keyword-rich alt text, which is also metadata used by search engines. See [Alt text](/en/contributing/style-guide-and-content-model/style-guide#alt-text) in the GitHub Docs Style Guide.\n\n### Link strategically\n\nLink frugally to other task-relevant pages on GitHub Docs and high-quality peer sites, following [Links](/en/contributing/style-guide-and-content-model/style-guide#links) in the GitHub Docs Style Guide.\n\nEnsure that incoming links do not break by carefully maintaining redirects.\n\n### Maintain accuracy\n\nEnsure content is free of errors in fact, spelling, and style. Audit content periodically to remove errors such as broken links and to retire unneeded content. See [Configuring redirects](/en/contributing/writing-for-github-docs/configuring-redirects)."}