prompt: We are currently solving the following issue within our repository. Here is the issue text:
  --- BEGIN ISSUE ---
  Improve Intro and Getting Started documentation
  I think the [introduction](https://docs.readthedocs.io/en/latest/) and [getting started guide](https://docs.readthedocs.io/en/latest/getting_started.html) could use a few improvements to make it easier for brand new users who may not already know about Sphinx/MkDocs/Markdown/RestructuredText and are just looking for a guide on how to write some docs.
  
  I also think our introduction could stand some improvements to point users in the right direction. We have a lot of docs, but a few layout and explanation improvements will help users find the right section for them.
  
  Here are some specific goals and improvements:
  
  - Make it easier to start a brand new docs project
    * Have a getting started guide for Sphinx
    * Have a getting started guide for Sphinx with commonmark
    * Have a getting started guide for MkDocs
    * Explain the why between the above technologies
  - Improve the intro paragraphs ("Read the Docs hosts documentation for...") on the index page to explain RTD's value proposition and why somebody should choose Read the Docs.
  - Full sentence/paragraph descriptions on different sections (eg. User documentation) rather than just a big toctree.
  
  --- END ISSUE ---
  
  Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
  --- BEGIN FILES ---
  Path: `docs/conf.py`
  Content:
  ```
  1 # -*- coding: utf-8 -*-
  2 
  3 from __future__ import division, print_function, unicode_literals
  4 
  5 import os
  6 import sys
  7 
  8 import sphinx_rtd_theme
  9 from recommonmark.parser import CommonMarkParser
  10 
  11 sys.path.insert(0, os.path.abspath('..'))
  12 sys.path.append(os.path.dirname(__file__))
  13 os.environ.setdefault("DJANGO_SETTINGS_MODULE", "readthedocs.settings.dev")
  14 
  15 from django.conf import settings
  16 from django.utils import timezone
  17 
  18 import django
  19 django.setup()
  20 
  21 
  22 sys.path.append(os.path.abspath('_ext'))
  23 extensions = [
  24     'sphinx.ext.autosectionlabel',
  25     'sphinx.ext.autodoc',
  26     'sphinx.ext.intersphinx',
  27     'sphinxcontrib.httpdomain',
  28     'djangodocs',
  29     'doc_extensions',
  30 ]
  31 templates_path = ['_templates']
  32 
  33 source_suffix = ['.rst', '.md']
  34 source_parsers = {
  35     '.md': CommonMarkParser,
  36 }
  37 
  38 master_doc = 'index'
  39 project = u'Read the Docs'
  40 copyright = '2010-{}, Read the Docs, Inc & contributors'.format(
  41     timezone.now().year
  42 )
  43 version = '1.0'
  44 release = '1.0'
  45 exclude_patterns = ['_build']
  46 default_role = 'obj'
  47 intersphinx_mapping = {
  48     'python': ('http://python.readthedocs.io/en/latest/', None),
  49     'django': ('http://django.readthedocs.io/en/1.9.x/', None),
  50     'sphinx': ('http://sphinx.readthedocs.io/en/latest/', None),
  51 }
  52 htmlhelp_basename = 'ReadTheDocsdoc'
  53 latex_documents = [
  54     ('index', 'ReadTheDocs.tex', u'Read the Docs Documentation',
  55      u'Eric Holscher, Charlie Leifer, Bobby Grace', 'manual'),
  56 ]
  57 man_pages = [
  58     ('index', 'read-the-docs', u'Read the Docs Documentation',
  59      [u'Eric Holscher, Charlie Leifer, Bobby Grace'], 1)
  60 ]
  61 
  62 exclude_patterns = [
  63     # 'api' # needed for ``make gettext`` to not die.
  64 ]
  65 
  66 language = 'en'
  67 
  68 locale_dirs = [
  69     'locale/',
  70 ]
  71 gettext_compact = False
  72 
  73 html_theme = 'sphinx_rtd_theme'
  74 # html_static_path = ['_static']
  75 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
  76 html_logo = 'img/logo.svg'
  77 html_theme_options = {
  78     'logo_only': True,
  79     'display_version': False,
  80 }
  81 
  82 # Activate autosectionlabel plugin
  83 autosectionlabel_prefix_document = True
  84
  ```
  --- END FILES ---
  
  Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.
  
  Here is an example:
  
  ```diff
  diff --git a/examples/server_async.py b/examples/server_async.py
  --- a/examples/server_async.py
  +++ b/examples/server_async.py
  @@ -313,4 +313,4 @@
   
   
   if __name__ == "__main__":
  -    asyncio.run(run_async_server("."), debug=True)
  +    asyncio.run(run_async_server(), debug=True)
  diff --git a/examples/server_sync.py b/examples/server_sync.py
  --- a/examples/server_sync.py
  +++ b/examples/server_sync.py
  @@ -313,5 +313,5 @@
   
   
   if __name__ == "__main__":
  -    server = run_sync_server(".")
  +    server = run_sync_server()
       server.shutdown()
  
  ```
  
golden_diff: diff --git a/docs/conf.py b/docs/conf.py
  --- a/docs/conf.py
  +++ b/docs/conf.py
  @@ -71,7 +71,7 @@
   gettext_compact = False
   
   html_theme = 'sphinx_rtd_theme'
  -# html_static_path = ['_static']
  +html_static_path = ['_static']
   html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
   html_logo = 'img/logo.svg'
   html_theme_options = {
  
verification_info: {"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -71,7 +71,7 @@\n gettext_compact = False\n \n html_theme = 'sphinx_rtd_theme'\n-# html_static_path = ['_static']\n+html_static_path = ['_static']\n html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]\n html_logo = 'img/logo.svg'\n html_theme_options = {\n", "issue": "Improve Intro and Getting Started documentation\nI think the [introduction](https://docs.readthedocs.io/en/latest/) and [getting started guide](https://docs.readthedocs.io/en/latest/getting_started.html) could use a few improvements to make it easier for brand new users who may not already know about Sphinx/MkDocs/Markdown/RestructuredText and are just looking for a guide on how to write some docs.\r\n\r\nI also think our introduction could stand some improvements to point users in the right direction. We have a lot of docs, but a few layout and explanation improvements will help users find the right section for them.\r\n\r\nHere are some specific goals and improvements:\r\n\r\n- Make it easier to start a brand new docs project\r\n  * Have a getting started guide for Sphinx\r\n  * Have a getting started guide for Sphinx with commonmark\r\n  * Have a getting started guide for MkDocs\r\n  * Explain the why between the above technologies\r\n- Improve the intro paragraphs (\"Read the Docs hosts documentation for...\") on the index page to explain RTD's value proposition and why somebody should choose Read the Docs.\r\n- Full sentence/paragraph descriptions on different sections (eg. User documentation) rather than just a big toctree.\n", "before_files": [{"content": "# -*- coding: utf-8 -*-\n\nfrom __future__ import division, print_function, unicode_literals\n\nimport os\nimport sys\n\nimport sphinx_rtd_theme\nfrom recommonmark.parser import CommonMarkParser\n\nsys.path.insert(0, os.path.abspath('..'))\nsys.path.append(os.path.dirname(__file__))\nos.environ.setdefault(\"DJANGO_SETTINGS_MODULE\", \"readthedocs.settings.dev\")\n\nfrom django.conf import settings\nfrom django.utils import timezone\n\nimport django\ndjango.setup()\n\n\nsys.path.append(os.path.abspath('_ext'))\nextensions = [\n    'sphinx.ext.autosectionlabel',\n    'sphinx.ext.autodoc',\n    'sphinx.ext.intersphinx',\n    'sphinxcontrib.httpdomain',\n    'djangodocs',\n    'doc_extensions',\n]\ntemplates_path = ['_templates']\n\nsource_suffix = ['.rst', '.md']\nsource_parsers = {\n    '.md': CommonMarkParser,\n}\n\nmaster_doc = 'index'\nproject = u'Read the Docs'\ncopyright = '2010-{}, Read the Docs, Inc & contributors'.format(\n    timezone.now().year\n)\nversion = '1.0'\nrelease = '1.0'\nexclude_patterns = ['_build']\ndefault_role = 'obj'\nintersphinx_mapping = {\n    'python': ('http://python.readthedocs.io/en/latest/', None),\n    'django': ('http://django.readthedocs.io/en/1.9.x/', None),\n    'sphinx': ('http://sphinx.readthedocs.io/en/latest/', None),\n}\nhtmlhelp_basename = 'ReadTheDocsdoc'\nlatex_documents = [\n    ('index', 'ReadTheDocs.tex', u'Read the Docs Documentation',\n     u'Eric Holscher, Charlie Leifer, Bobby Grace', 'manual'),\n]\nman_pages = [\n    ('index', 'read-the-docs', u'Read the Docs Documentation',\n     [u'Eric Holscher, Charlie Leifer, Bobby Grace'], 1)\n]\n\nexclude_patterns = [\n    # 'api' # needed for ``make gettext`` to not die.\n]\n\nlanguage = 'en'\n\nlocale_dirs = [\n    'locale/',\n]\ngettext_compact = False\n\nhtml_theme = 'sphinx_rtd_theme'\n# html_static_path = ['_static']\nhtml_theme_path = [sphinx_rtd_theme.get_html_theme_path()]\nhtml_logo = 'img/logo.svg'\nhtml_theme_options = {\n    'logo_only': True,\n    'display_version': False,\n}\n\n# Activate autosectionlabel plugin\nautosectionlabel_prefix_document = True\n", "path": "docs/conf.py"}], "after_files": [{"content": "# -*- coding: utf-8 -*-\n\nfrom __future__ import division, print_function, unicode_literals\n\nimport os\nimport sys\n\nimport sphinx_rtd_theme\nfrom recommonmark.parser import CommonMarkParser\n\nsys.path.insert(0, os.path.abspath('..'))\nsys.path.append(os.path.dirname(__file__))\nos.environ.setdefault(\"DJANGO_SETTINGS_MODULE\", \"readthedocs.settings.dev\")\n\nfrom django.conf import settings\nfrom django.utils import timezone\n\nimport django\ndjango.setup()\n\n\nsys.path.append(os.path.abspath('_ext'))\nextensions = [\n    'sphinx.ext.autosectionlabel',\n    'sphinx.ext.autodoc',\n    'sphinx.ext.intersphinx',\n    'sphinxcontrib.httpdomain',\n    'djangodocs',\n    'doc_extensions',\n]\ntemplates_path = ['_templates']\n\nsource_suffix = ['.rst', '.md']\nsource_parsers = {\n    '.md': CommonMarkParser,\n}\n\nmaster_doc = 'index'\nproject = u'Read the Docs'\ncopyright = '2010-{}, Read the Docs, Inc & contributors'.format(\n    timezone.now().year\n)\nversion = '1.0'\nrelease = '1.0'\nexclude_patterns = ['_build']\ndefault_role = 'obj'\nintersphinx_mapping = {\n    'python': ('http://python.readthedocs.io/en/latest/', None),\n    'django': ('http://django.readthedocs.io/en/1.9.x/', None),\n    'sphinx': ('http://sphinx.readthedocs.io/en/latest/', None),\n}\nhtmlhelp_basename = 'ReadTheDocsdoc'\nlatex_documents = [\n    ('index', 'ReadTheDocs.tex', u'Read the Docs Documentation',\n     u'Eric Holscher, Charlie Leifer, Bobby Grace', 'manual'),\n]\nman_pages = [\n    ('index', 'read-the-docs', u'Read the Docs Documentation',\n     [u'Eric Holscher, Charlie Leifer, Bobby Grace'], 1)\n]\n\nexclude_patterns = [\n    # 'api' # needed for ``make gettext`` to not die.\n]\n\nlanguage = 'en'\n\nlocale_dirs = [\n    'locale/',\n]\ngettext_compact = False\n\nhtml_theme = 'sphinx_rtd_theme'\nhtml_static_path = ['_static']\nhtml_theme_path = [sphinx_rtd_theme.get_html_theme_path()]\nhtml_logo = 'img/logo.svg'\nhtml_theme_options = {\n    'logo_only': True,\n    'display_version': False,\n}\n\n# Activate autosectionlabel plugin\nautosectionlabel_prefix_document = True\n", "path": "docs/conf.py"}]}