We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
documentation is a mix of markdown and restructuredtext
### Issue description

documentation is a mix of markdown and restructuredtext, but the [documentation says the documentation is restructuredtext](https://pipenv.pypa.io/en/latest/dev/contributing/#documentation-contributions). I found out commit 761a03d seemingly did a conversion to markdown which did not go all the way to the end.
I would like to know what is the pursued direction (markdown + restructuredtext or full markdown), and if the direction is full markdown, try to help.

### Expected result

* either the documentation says the documentation is both markdown and restructuredtext
* either we clean out one of them (restructuredtext, I guess)

### Actual result

mix of both

### Steps to replicate

N/A

--- 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 #
2 # pipenv documentation build configuration file, created by
3 # sphinx-quickstart on Mon Jan 30 13:28:36 2017.
4 #
5 # This file is execfile()d with the current directory set to its
6 # containing dir.
7 #
8 # Note that not all possible configuration values are present in this
9 # autogenerated file.
10 #
11 # All configuration values have a default; values that are commented out
12 # serve to show the default.
13 
14 # If extensions (or modules to document with autodoc) are in another directory,
15 # add these directories to sys.path here. If the directory is relative to the
16 # documentation root, use os.path.abspath to make it absolute, like shown here.
17 #
18 import os
19 
20 # Path hackery to get current version number.
21 here = os.path.abspath(os.path.dirname(__file__))
22 
23 about = {}
24 with open(os.path.join(here, "..", "pipenv", "__version__.py")) as f:
25     exec(f.read(), about)
26 
27 # Hackery to get the CLI docs to generate
28 import click
29 
30 import pipenv.vendor.click
31 
32 click.Command = pipenv.vendor.click.Command
33 click.Group = pipenv.vendor.click.Group
34 click.BaseCommand = pipenv.vendor.click.BaseCommand
35 # -- General configuration ------------------------------------------------
36 
37 # If your documentation needs a minimal Sphinx version, state it here.
38 #
39 # needs_sphinx = '1.0'
40 
41 # Add any Sphinx extension module names here, as strings. They can be
42 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
43 # ones.
44 extensions = [
45     "sphinx.ext.autodoc",
46     "sphinx.ext.todo",
47     "sphinx.ext.coverage",
48     "sphinx.ext.viewcode",
49     "myst_parser",
50     "sphinx_click",
51 ]
52 
53 # Add any paths that contain templates here, relative to this directory.
54 templates_path = ["_templates"]
55 
56 myst_enable_extensions = [
57     "amsmath",
58     "colon_fence",
59     "deflist",
60     "dollarmath",
61     "fieldlist",
62     "html_admonition",
63     "html_image",
64     "linkify",
65     "replacements",
66     "smartquotes",
67     "strikethrough",
68     "substitution",
69     "tasklist",
70 ]
71 
72 # The suffix(es) of source filenames.
73 # You can specify multiple suffix as a list of string:
74 #
75 # source_suffix = ['.rst', '.md']
76 source_suffix = ".rst"
77 
78 # The master toctree document.
79 master_doc = "index"
80 
81 # General information about the project.
82 project = "pipenv"
83 copyright = '2020. A project founded by Kenneth Reitz and maintained by <a href="https://www.pypa.io/en/latest/">Python Packaging Authority (PyPA).</a>'
84 author = "Python Packaging Authority"
85 
86 # The version info for the project you're documenting, acts as replacement for
87 # |version| and |release|, also used in various other places throughout the
88 # built documents.
89 #
90 # The short X.Y version.
91 version = about["__version__"]
92 # The full version, including alpha/beta/rc tags.
93 release = about["__version__"]
94 
95 # The language for content autogenerated by Sphinx. Refer to documentation
96 # for a list of supported languages.
97 #
98 # This is also used if you do content translation via gettext catalogs.
99 # Usually you set "language" from the command line for these cases.
100 language = None
101 
102 # List of patterns, relative to source directory, that match files and
103 # directories to ignore when looking for source files.
104 # This patterns also effect to html_static_path and html_extra_path
105 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
106 
107 # The name of the Pygments (syntax highlighting) style to use.
108 pygments_style = "sphinx"
109 
110 # If true, `todo` and `todoList` produce output, else they produce nothing.
111 todo_include_todos = True
112 
113 # -- Options for HTML output ----------------------------------------------
114 
115 # The theme to use for HTML and HTML Help pages.  See the documentation for
116 # a list of builtin themes.
117 #
118 html_theme = "alabaster"
119 
120 # Theme options are theme-specific and customize the look and feel of a theme
121 # further.  For a list of options available for each theme, see the
122 # documentation.
123 #
124 html_theme_options = {
125     "show_powered_by": False,
126     "github_user": "pypa",
127     "github_repo": "pipenv",
128     "github_banner": False,
129     "show_related": False,
130 }
131 
132 html_sidebars = {
133     "index": ["sidebarlogo.html", "sourcelink.html", "searchbox.html", "hacks.html"],
134     "**": [
135         "sidebarlogo.html",
136         "localtoc.html",
137         "relations.html",
138         "sourcelink.html",
139         "searchbox.html",
140         "hacks.html",
141     ],
142 }
143 
144 
145 # Add any paths that contain custom static files (such as style sheets) here,
146 # relative to this directory. They are copied after the builtin static files,
147 # so a file named "default.css" will overwrite the builtin "default.css".
148 html_static_path = ["_static"]
149 
150 
151 def setup(app):
152     app.add_css_file("custom.css")
153 
154 
155 # -- Options for HTMLHelp output ------------------------------------------
156 
157 # Output file base name for HTML help builder.
158 htmlhelp_basename = "pipenvdoc"
159 
160 
161 # -- Options for LaTeX output ---------------------------------------------
162 
163 latex_elements = {
164     # The paper size ('letterpaper' or 'a4paper').
165     #
166     # 'papersize': 'letterpaper',
167     # The font size ('10pt', '11pt' or '12pt').
168     #
169     # 'pointsize': '10pt',
170     # Additional stuff for the LaTeX preamble.
171     #
172     # 'preamble': '',
173     # Latex figure (float) alignment
174     #
175     # 'figure_align': 'htbp',
176 }
177 
178 # Grouping the document tree into LaTeX files. List of tuples
179 # (source start file, target name, title,
180 #  author, documentclass [howto, manual, or own class]).
181 latex_documents = [
182     (master_doc, "pipenv.tex", "pipenv Documentation", "Kenneth Reitz", "manual"),
183 ]
184 
185 
186 # -- Options for manual page output ---------------------------------------
187 
188 # One entry per manual page. List of tuples
189 # (source start file, name, description, authors, manual section).
190 man_pages = [("quickstart", "pipenv", "", [author], 1)]
191 
192 
193 # -- Options for Texinfo output -------------------------------------------
194 
195 # Grouping the document tree into Texinfo files. List of tuples
196 # (source start file, target name, title, author,
197 #  dir menu entry, description, category)
198 texinfo_documents = [
199     (
200         master_doc,
201         "pipenv",
202         "pipenv Documentation",
203         author,
204         "pipenv",
205         "One line description of project.",
206         "Miscellaneous",
207     ),
208 ]
209 
210 
211 # -- Options for Epub output ----------------------------------------------
212 
213 # Bibliographic Dublin Core info.
214 epub_title = project
215 epub_author = author
216 epub_publisher = author
217 epub_copyright = copyright
218 
219 # The unique identifier of the text. This can be a ISBN number
220 # or the project homepage.
221 #
222 # epub_identifier = ''
223 
224 # A unique identification for the text.
225 #
226 # epub_uid = ''
227 
228 # A list of files that should not be packed into the epub file.
229 epub_exclude_files = ["search.html"]
230
```
--- 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()

```

diff --git a/docs/conf.py b/docs/conf.py
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -72,8 +72,8 @@
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
-# source_suffix = ['.rst', '.md']
-source_suffix = ".rst"
+source_suffix = [".rst", ".md"]
+# source_suffix = ".rst"
 
 # The master toctree document.
 master_doc = "index"

{"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -72,8 +72,8 @@\n # The suffix(es) of source filenames.\n # You can specify multiple suffix as a list of string:\n #\n-# source_suffix = ['.rst', '.md']\n-source_suffix = \".rst\"\n+source_suffix = [\".rst\", \".md\"]\n+# source_suffix = \".rst\"\n \n # The master toctree document.\n master_doc = \"index\"\n", "issue": "documentation is a mix of markdown and restructuredtext\n### Issue description\r\n\r\ndocumentation is a mix of markdown and restructuredtext, but the [documentation says the documentation is restructuredtext](https://pipenv.pypa.io/en/latest/dev/contributing/#documentation-contributions). I found out commit 761a03d seemingly did a conversion to markdown which did not go all the way to the end.\r\nI would like to know what is the pursued direction (markdown + restructuredtext or full markdown), and if the direction is full markdown, try to help.\r\n\r\n### Expected result\r\n\r\n* either the documentation says the documentation is both markdown and restructuredtext\r\n* either we clean out one of them (restructuredtext, I guess)\r\n\r\n### Actual result\r\n\r\nmix of both\r\n\r\n### Steps to replicate\r\n\r\nN/A\n", "before_files": [{"content": "#\n# pipenv documentation build configuration file, created by\n# sphinx-quickstart on Mon Jan 30 13:28:36 2017.\n#\n# This file is execfile()d with the current directory set to its\n# containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\nimport os\n\n# Path hackery to get current version number.\nhere = os.path.abspath(os.path.dirname(__file__))\n\nabout = {}\nwith open(os.path.join(here, \"..\", \"pipenv\", \"__version__.py\")) as f:\n    exec(f.read(), about)\n\n# Hackery to get the CLI docs to generate\nimport click\n\nimport pipenv.vendor.click\n\nclick.Command = pipenv.vendor.click.Command\nclick.Group = pipenv.vendor.click.Group\nclick.BaseCommand = pipenv.vendor.click.BaseCommand\n# -- General configuration ------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#\n# needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n    \"sphinx.ext.autodoc\",\n    \"sphinx.ext.todo\",\n    \"sphinx.ext.coverage\",\n    \"sphinx.ext.viewcode\",\n    \"myst_parser\",\n    \"sphinx_click\",\n]\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\nmyst_enable_extensions = [\n    \"amsmath\",\n    \"colon_fence\",\n    \"deflist\",\n    \"dollarmath\",\n    \"fieldlist\",\n    \"html_admonition\",\n    \"html_image\",\n    \"linkify\",\n    \"replacements\",\n    \"smartquotes\",\n    \"strikethrough\",\n    \"substitution\",\n    \"tasklist\",\n]\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\n#\n# source_suffix = ['.rst', '.md']\nsource_suffix = \".rst\"\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# General information about the project.\nproject = \"pipenv\"\ncopyright = '2020. A project founded by Kenneth Reitz and maintained by <a href=\"https://www.pypa.io/en/latest/\">Python Packaging Authority (PyPA).</a>'\nauthor = \"Python Packaging Authority\"\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The short X.Y version.\nversion = about[\"__version__\"]\n# The full version, including alpha/beta/rc tags.\nrelease = about[\"__version__\"]\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = None\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This patterns also effect to html_static_path and html_extra_path\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = True\n\n# -- Options for HTML output ----------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n#\nhtml_theme = \"alabaster\"\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further.  For a list of options available for each theme, see the\n# documentation.\n#\nhtml_theme_options = {\n    \"show_powered_by\": False,\n    \"github_user\": \"pypa\",\n    \"github_repo\": \"pipenv\",\n    \"github_banner\": False,\n    \"show_related\": False,\n}\n\nhtml_sidebars = {\n    \"index\": [\"sidebarlogo.html\", \"sourcelink.html\", \"searchbox.html\", \"hacks.html\"],\n    \"**\": [\n        \"sidebarlogo.html\",\n        \"localtoc.html\",\n        \"relations.html\",\n        \"sourcelink.html\",\n        \"searchbox.html\",\n        \"hacks.html\",\n    ],\n}\n\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\n\n\ndef setup(app):\n    app.add_css_file(\"custom.css\")\n\n\n# -- Options for HTMLHelp output ------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"pipenvdoc\"\n\n\n# -- Options for LaTeX output ---------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    #\n    # 'papersize': 'letterpaper',\n    # The font size ('10pt', '11pt' or '12pt').\n    #\n    # 'pointsize': '10pt',\n    # Additional stuff for the LaTeX preamble.\n    #\n    # 'preamble': '',\n    # Latex figure (float) alignment\n    #\n    # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n    (master_doc, \"pipenv.tex\", \"pipenv Documentation\", \"Kenneth Reitz\", \"manual\"),\n]\n\n\n# -- Options for manual page output ---------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [(\"quickstart\", \"pipenv\", \"\", [author], 1)]\n\n\n# -- Options for Texinfo output -------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [\n    (\n        master_doc,\n        \"pipenv\",\n        \"pipenv Documentation\",\n        author,\n        \"pipenv\",\n        \"One line description of project.\",\n        \"Miscellaneous\",\n    ),\n]\n\n\n# -- Options for Epub output ----------------------------------------------\n\n# Bibliographic Dublin Core info.\nepub_title = project\nepub_author = author\nepub_publisher = author\nepub_copyright = copyright\n\n# The unique identifier of the text. This can be a ISBN number\n# or the project homepage.\n#\n# epub_identifier = ''\n\n# A unique identification for the text.\n#\n# epub_uid = ''\n\n# A list of files that should not be packed into the epub file.\nepub_exclude_files = [\"search.html\"]\n", "path": "docs/conf.py"}], "after_files": [{"content": "#\n# pipenv documentation build configuration file, created by\n# sphinx-quickstart on Mon Jan 30 13:28:36 2017.\n#\n# This file is execfile()d with the current directory set to its\n# containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\nimport os\n\n# Path hackery to get current version number.\nhere = os.path.abspath(os.path.dirname(__file__))\n\nabout = {}\nwith open(os.path.join(here, \"..\", \"pipenv\", \"__version__.py\")) as f:\n    exec(f.read(), about)\n\n# Hackery to get the CLI docs to generate\nimport click\n\nimport pipenv.vendor.click\n\nclick.Command = pipenv.vendor.click.Command\nclick.Group = pipenv.vendor.click.Group\nclick.BaseCommand = pipenv.vendor.click.BaseCommand\n# -- General configuration ------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#\n# needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n    \"sphinx.ext.autodoc\",\n    \"sphinx.ext.todo\",\n    \"sphinx.ext.coverage\",\n    \"sphinx.ext.viewcode\",\n    \"myst_parser\",\n    \"sphinx_click\",\n]\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\nmyst_enable_extensions = [\n    \"amsmath\",\n    \"colon_fence\",\n    \"deflist\",\n    \"dollarmath\",\n    \"fieldlist\",\n    \"html_admonition\",\n    \"html_image\",\n    \"linkify\",\n    \"replacements\",\n    \"smartquotes\",\n    \"strikethrough\",\n    \"substitution\",\n    \"tasklist\",\n]\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\n#\nsource_suffix = [\".rst\", \".md\"]\n# source_suffix = \".rst\"\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# General information about the project.\nproject = \"pipenv\"\ncopyright = '2020. A project founded by Kenneth Reitz and maintained by <a href=\"https://www.pypa.io/en/latest/\">Python Packaging Authority (PyPA).</a>'\nauthor = \"Python Packaging Authority\"\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The short X.Y version.\nversion = about[\"__version__\"]\n# The full version, including alpha/beta/rc tags.\nrelease = about[\"__version__\"]\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = None\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This patterns also effect to html_static_path and html_extra_path\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = True\n\n# -- Options for HTML output ----------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n#\nhtml_theme = \"alabaster\"\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further.  For a list of options available for each theme, see the\n# documentation.\n#\nhtml_theme_options = {\n    \"show_powered_by\": False,\n    \"github_user\": \"pypa\",\n    \"github_repo\": \"pipenv\",\n    \"github_banner\": False,\n    \"show_related\": False,\n}\n\nhtml_sidebars = {\n    \"index\": [\"sidebarlogo.html\", \"sourcelink.html\", \"searchbox.html\", \"hacks.html\"],\n    \"**\": [\n        \"sidebarlogo.html\",\n        \"localtoc.html\",\n        \"relations.html\",\n        \"sourcelink.html\",\n        \"searchbox.html\",\n        \"hacks.html\",\n    ],\n}\n\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\n\n\ndef setup(app):\n    app.add_css_file(\"custom.css\")\n\n\n# -- Options for HTMLHelp output ------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"pipenvdoc\"\n\n\n# -- Options for LaTeX output ---------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    #\n    # 'papersize': 'letterpaper',\n    # The font size ('10pt', '11pt' or '12pt').\n    #\n    # 'pointsize': '10pt',\n    # Additional stuff for the LaTeX preamble.\n    #\n    # 'preamble': '',\n    # Latex figure (float) alignment\n    #\n    # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n    (master_doc, \"pipenv.tex\", \"pipenv Documentation\", \"Kenneth Reitz\", \"manual\"),\n]\n\n\n# -- Options for manual page output ---------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [(\"quickstart\", \"pipenv\", \"\", [author], 1)]\n\n\n# -- Options for Texinfo output -------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [\n    (\n        master_doc,\n        \"pipenv\",\n        \"pipenv Documentation\",\n        author,\n        \"pipenv\",\n        \"One line description of project.\",\n        \"Miscellaneous\",\n    ),\n]\n\n\n# -- Options for Epub output ----------------------------------------------\n\n# Bibliographic Dublin Core info.\nepub_title = project\nepub_author = author\nepub_publisher = author\nepub_copyright = copyright\n\n# The unique identifier of the text. This can be a ISBN number\n# or the project homepage.\n#\n# epub_identifier = ''\n\n# A unique identification for the text.\n#\n# epub_uid = ''\n\n# A list of files that should not be packed into the epub file.\nepub_exclude_files = [\"search.html\"]\n", "path": "docs/conf.py"}]}