From a38bee48f5f1164d65ffe350ae8151e7d777c52b Mon Sep 17 00:00:00 2001 From: David Fischer Date: Mon, 26 Aug 2019 14:04:38 -0700 Subject: [PATCH] Small improvements to the SEO guide --- docs/guides/technical-docs-seo-guide.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/guides/technical-docs-seo-guide.rst b/docs/guides/technical-docs-seo-guide.rst index 8db8a658d6f..30be1b7f168 100644 --- a/docs/guides/technical-docs-seo-guide.rst +++ b/docs/guides/technical-docs-seo-guide.rst @@ -58,7 +58,11 @@ To summarize some of the most important aspects as they apply to technical documentation, your site should: * Use descriptive and accurate titles in the HTML ```` tag. + For Sphinx, the ``<title>`` comes from the first heading on the page. * Ensure your URLs are descriptive. They are displayed in search results. + Sphinx uses the source filename without the file extension as the URL. +* Make sure the words your readers would search for to find your site + are actually included on your pages. * Avoid low content pages or pages with very little original content. * Avoid tactics that attempt to increase your search engine ranking without actually improving content.