We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
Same as Issue 179. Adding examples in Readme.rst
Hi, I will like to add a continuation of issue 179 to improve the examples in the API section of readme.rst 

--- 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 # Configuration file for the Sphinx documentation builder.
4 #
5 # This file does only contain a selection of the most common options. For a
6 # full list see the documentation:
7 # http://www.sphinx-doc.org/en/stable/config
8 
9 # -- Path setup --------------------------------------------------------------
10 
11 # If extensions (or modules to document with autodoc) are in another directory,
12 # add these directories to sys.path here. If the directory is relative to the
13 # documentation root, use os.path.abspath to make it absolute, like shown here.
14 #
15 import os
16 import sys
17 sys.path.insert(0, os.path.abspath('.'))
18 sys.path.insert(0, os.path.abspath('../examples'))
19 
20 # Make a symlink in our sphinx source directory to the top-level
21 # examples/notebooks directory so we can include notebooks in the doc
22 from pathlib import Path
23 notebooks = Path("./notebooks")
24 if not notebooks.exists():
25     print("Making symlink to ../examples/notebooks")
26     notebooks.symlink_to("../examples/notebooks")
27 
28 
29 # -- Project information -----------------------------------------------------
30 
31 project = "pyjanitor"
32 copyright = "2018, Eric J. Ma"
33 author = "Eric J. Ma"
34 
35 # The short X.Y version
36 version = "0.1.0"
37 # The full version, including alpha/beta/rc tags
38 release = ""
39 
40 
41 # -- General configuration ---------------------------------------------------
42 
43 # If your documentation needs a minimal Sphinx version, state it here.
44 #
45 # needs_sphinx = '1.0'
46 
47 # Add any Sphinx extension module names here, as strings. They can be
48 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
49 # ones.
50 extensions = [
51     "sphinx.ext.autodoc",
52     "sphinx.ext.doctest",
53     "sphinx.ext.intersphinx",
54     "sphinx.ext.todo",
55     "sphinx.ext.coverage",
56     "sphinx.ext.viewcode",
57     "sphinx.ext.githubpages",
58     "sphinxcontrib.fulltoc",
59     "nbsphinx",
60 ]
61 
62 # Add any paths that contain templates here, relative to this directory.
63 templates_path = ["_templates"]
64 
65 # The suffix(es) of source filenames.
66 # You can specify multiple suffix as a list of string:
67 #
68 # source_suffix = ['.rst', '.md']
69 source_suffix = [".md", ".rst", ".ipynb"]
70 
71 # The master toctree document.
72 master_doc = "index"
73 
74 # The language for content autogenerated by Sphinx. Refer to documentation
75 # for a list of supported languages.
76 #
77 # This is also used if you do content translation via gettext catalogs.
78 # Usually you set "language" from the command line for these cases.
79 language = None
80 
81 # List of patterns, relative to source directory, that match files and
82 # directories to ignore when looking for source files.
83 # This pattern also affects html_static_path and html_extra_path .
84 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "**.ipynb_checkpoints"]
85 
86 # The name of the Pygments (syntax highlighting) style to use.
87 pygments_style = "sphinx"
88 
89 
90 # -- Options for HTML output -------------------------------------------------
91 
92 # The theme to use for HTML and HTML Help pages.  See the documentation for
93 # a list of builtin themes.
94 #
95 html_theme = "alabaster"
96 
97 # Theme options are theme-specific and customize the look and feel of a theme
98 # further.  For a list of options available for each theme, see the
99 # documentation.
100 #
101 # html_theme_options = {}
102 
103 # Add any paths that contain custom static files (such as style sheets) here,
104 # relative to this directory. They are copied after the builtin static files,
105 # so a file named "default.css" will overwrite the builtin "default.css".
106 html_static_path = ["_static"]
107 
108 # Custom sidebar templates, must be a dictionary that maps document names
109 # to template names.
110 #
111 # The default sidebars (for documents that don't match any pattern) are
112 # defined by theme itself.  Builtin themes are using these templates by
113 # default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
114 # 'searchbox.html']``.
115 #
116 # html_sidebars = {}
117 
118 
119 # -- Options for HTMLHelp output ---------------------------------------------
120 
121 # Output file base name for HTML help builder.
122 htmlhelp_basename = "pyjanitordoc"
123 
124 
125 # -- Options for LaTeX output ------------------------------------------------
126 
127 latex_elements = {
128     # The paper size ('letterpaper' or 'a4paper').
129     #
130     # 'papersize': 'letterpaper',
131     # The font size ('10pt', '11pt' or '12pt').
132     #
133     # 'pointsize': '10pt',
134     # Additional stuff for the LaTeX preamble.
135     #
136     # 'preamble': '',
137     # Latex figure (float) alignment
138     #
139     # 'figure_align': 'htbp',
140 }
141 
142 # Grouping the document tree into LaTeX files. List of tuples
143 # (source start file, target name, title,
144 #  author, documentclass [howto, manual, or own class]).
145 latex_documents = [
146     (
147         master_doc,
148         "pyjanitor.tex",
149         "pyjanitor Documentation",
150         "Eric J. Ma",
151         "manual",
152     )
153 ]
154 
155 
156 # -- Options for manual page output ------------------------------------------
157 
158 # One entry per manual page. List of tuples
159 # (source start file, name, description, authors, manual section).
160 man_pages = [(master_doc, "pyjanitor", "pyjanitor Documentation", [author], 1)]
161 
162 
163 # -- Options for Texinfo output ----------------------------------------------
164 
165 # Grouping the document tree into Texinfo files. List of tuples
166 # (source start file, target name, title, author,
167 #  dir menu entry, description, category)
168 texinfo_documents = [
169     (
170         master_doc,
171         "pyjanitor",
172         "pyjanitor Documentation",
173         author,
174         "pyjanitor",
175         "One line description of project.",
176         "Miscellaneous",
177     )
178 ]
179 
180 
181 # -- Extension configuration -------------------------------------------------
182 
183 # -- Options for intersphinx extension ---------------------------------------
184 
185 # Example configuration for intersphinx: refer to the Python standard library.
186 intersphinx_mapping = {
187     "https://docs.python.org/": None,
188     "https://pandas.pydata.org/pandas-docs/stable": None,
189 }
190 
191 # -- Options for todo extension ----------------------------------------------
192 
193 # If true, `todo` and `todoList` produce output, else they produce nothing.
194 todo_include_todos = True
195
```
--- 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
@@ -12,9 +12,18 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
+import os
+import sys
+sys.path.insert(0, os.path.abspath('.'))
+sys.path.insert(0, os.path.abspath('../examples'))
+
+# Make a symlink in our sphinx source directory to the top-level
+# examples/notebooks directory so we can include notebooks in the doc
+from pathlib import Path
+notebooks = Path("./notebooks")
+if not notebooks.exists():
+    print("Making symlink to ../examples/notebooks")
+    notebooks.symlink_to("../examples/notebooks")
 
 
 # -- Project information -----------------------------------------------------
@@ -47,6 +56,7 @@
     "sphinx.ext.viewcode",
     "sphinx.ext.githubpages",
     "sphinxcontrib.fulltoc",
+    "nbsphinx",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -56,7 +66,7 @@
 # You can specify multiple suffix as a list of string:
 #
 # source_suffix = ['.rst', '.md']
-source_suffix = [".md", ".rst"]
+source_suffix = [".md", ".rst", ".ipynb"]
 
 # The master toctree document.
 master_doc = "index"
@@ -71,7 +81,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path .
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "**.ipynb_checkpoints"]
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = "sphinx"

{"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -12,9 +12,18 @@\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 #\n-# import os\n-# import sys\n-# sys.path.insert(0, os.path.abspath('.'))\n+import os\n+import sys\n+sys.path.insert(0, os.path.abspath('.'))\n+sys.path.insert(0, os.path.abspath('../examples'))\n+\n+# Make a symlink in our sphinx source directory to the top-level\n+# examples/notebooks directory so we can include notebooks in the doc\n+from pathlib import Path\n+notebooks = Path(\"./notebooks\")\n+if not notebooks.exists():\n+    print(\"Making symlink to ../examples/notebooks\")\n+    notebooks.symlink_to(\"../examples/notebooks\")\n \n \n # -- Project information -----------------------------------------------------\n@@ -47,6 +56,7 @@\n     \"sphinx.ext.viewcode\",\n     \"sphinx.ext.githubpages\",\n     \"sphinxcontrib.fulltoc\",\n+    \"nbsphinx\",\n ]\n \n # Add any paths that contain templates here, relative to this directory.\n@@ -56,7 +66,7 @@\n # You can specify multiple suffix as a list of string:\n #\n # source_suffix = ['.rst', '.md']\n-source_suffix = [\".md\", \".rst\"]\n+source_suffix = [\".md\", \".rst\", \".ipynb\"]\n \n # The master toctree document.\n master_doc = \"index\"\n@@ -71,7 +81,7 @@\n # List of patterns, relative to source directory, that match files and\n # directories to ignore when looking for source files.\n # This pattern also affects html_static_path and html_extra_path .\n-exclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\"]\n+exclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\", \"**.ipynb_checkpoints\"]\n \n # The name of the Pygments (syntax highlighting) style to use.\n pygments_style = \"sphinx\"\n", "issue": "Same as Issue 179. Adding examples in Readme.rst\nHi, I will like to add a continuation of issue 179 to improve the examples in the API section of readme.rst \n", "before_files": [{"content": "# -*- coding: utf-8 -*-\n#\n# Configuration file for the Sphinx documentation builder.\n#\n# This file does only contain a selection of the most common options. For a\n# full list see the documentation:\n# http://www.sphinx-doc.org/en/stable/config\n\n# -- Path setup --------------------------------------------------------------\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\nimport sys\nsys.path.insert(0, os.path.abspath('.'))\nsys.path.insert(0, os.path.abspath('../examples'))\n\n# Make a symlink in our sphinx source directory to the top-level\n# examples/notebooks directory so we can include notebooks in the doc\nfrom pathlib import Path\nnotebooks = Path(\"./notebooks\")\nif not notebooks.exists():\n    print(\"Making symlink to ../examples/notebooks\")\n    notebooks.symlink_to(\"../examples/notebooks\")\n\n\n# -- Project information -----------------------------------------------------\n\nproject = \"pyjanitor\"\ncopyright = \"2018, Eric J. Ma\"\nauthor = \"Eric J. Ma\"\n\n# The short X.Y version\nversion = \"0.1.0\"\n# The full version, including alpha/beta/rc tags\nrelease = \"\"\n\n\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.doctest\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.todo\",\n    \"sphinx.ext.coverage\",\n    \"sphinx.ext.viewcode\",\n    \"sphinx.ext.githubpages\",\n    \"sphinxcontrib.fulltoc\",\n    \"nbsphinx\",\n]\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\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 = [\".md\", \".rst\", \".ipynb\"]\n\n# The master toctree document.\nmaster_doc = \"index\"\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 pattern also affects html_static_path and html_extra_path .\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\", \"**.ipynb_checkpoints\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\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#\n# html_theme_options = {}\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# Custom sidebar templates, must be a dictionary that maps document names\n# to template names.\n#\n# The default sidebars (for documents that don't match any pattern) are\n# defined by theme itself.  Builtin themes are using these templates by\n# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',\n# 'searchbox.html']``.\n#\n# html_sidebars = {}\n\n\n# -- Options for HTMLHelp output ---------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"pyjanitordoc\"\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    (\n        master_doc,\n        \"pyjanitor.tex\",\n        \"pyjanitor Documentation\",\n        \"Eric J. Ma\",\n        \"manual\",\n    )\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 = [(master_doc, \"pyjanitor\", \"pyjanitor Documentation\", [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        \"pyjanitor\",\n        \"pyjanitor Documentation\",\n        author,\n        \"pyjanitor\",\n        \"One line description of project.\",\n        \"Miscellaneous\",\n    )\n]\n\n\n# -- Extension configuration -------------------------------------------------\n\n# -- Options for intersphinx extension ---------------------------------------\n\n# Example configuration for intersphinx: refer to the Python standard library.\nintersphinx_mapping = {\n    \"https://docs.python.org/\": None,\n    \"https://pandas.pydata.org/pandas-docs/stable\": None,\n}\n\n# -- Options for todo extension ----------------------------------------------\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = True\n", "path": "docs/conf.py"}], "after_files": [{"content": "# -*- coding: utf-8 -*-\n#\n# Configuration file for the Sphinx documentation builder.\n#\n# This file does only contain a selection of the most common options. For a\n# full list see the documentation:\n# http://www.sphinx-doc.org/en/stable/config\n\n# -- Path setup --------------------------------------------------------------\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\nimport sys\nsys.path.insert(0, os.path.abspath('.'))\nsys.path.insert(0, os.path.abspath('../examples'))\n\n# Make a symlink in our sphinx source directory to the top-level\n# examples/notebooks directory so we can include notebooks in the doc\nfrom pathlib import Path\nnotebooks = Path(\"./notebooks\")\nif not notebooks.exists():\n    print(\"Making symlink to ../examples/notebooks\")\n    notebooks.symlink_to(\"../examples/notebooks\")\n\n\n# -- Project information -----------------------------------------------------\n\nproject = \"pyjanitor\"\ncopyright = \"2018, Eric J. Ma\"\nauthor = \"Eric J. Ma\"\n\n# The short X.Y version\nversion = \"0.1.0\"\n# The full version, including alpha/beta/rc tags\nrelease = \"\"\n\n\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.doctest\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.todo\",\n    \"sphinx.ext.coverage\",\n    \"sphinx.ext.viewcode\",\n    \"sphinx.ext.githubpages\",\n    \"sphinxcontrib.fulltoc\",\n    \"nbsphinx\",\n]\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\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 = [\".md\", \".rst\", \".ipynb\"]\n\n# The master toctree document.\nmaster_doc = \"index\"\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 pattern also affects html_static_path and html_extra_path .\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\", \"**.ipynb_checkpoints\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\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#\n# html_theme_options = {}\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# Custom sidebar templates, must be a dictionary that maps document names\n# to template names.\n#\n# The default sidebars (for documents that don't match any pattern) are\n# defined by theme itself.  Builtin themes are using these templates by\n# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',\n# 'searchbox.html']``.\n#\n# html_sidebars = {}\n\n\n# -- Options for HTMLHelp output ---------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"pyjanitordoc\"\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    (\n        master_doc,\n        \"pyjanitor.tex\",\n        \"pyjanitor Documentation\",\n        \"Eric J. Ma\",\n        \"manual\",\n    )\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 = [(master_doc, \"pyjanitor\", \"pyjanitor Documentation\", [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        \"pyjanitor\",\n        \"pyjanitor Documentation\",\n        author,\n        \"pyjanitor\",\n        \"One line description of project.\",\n        \"Miscellaneous\",\n    )\n]\n\n\n# -- Extension configuration -------------------------------------------------\n\n# -- Options for intersphinx extension ---------------------------------------\n\n# Example configuration for intersphinx: refer to the Python standard library.\nintersphinx_mapping = {\n    \"https://docs.python.org/\": None,\n    \"https://pandas.pydata.org/pandas-docs/stable\": None,\n}\n\n# -- Options for todo extension ----------------------------------------------\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = True\n", "path": "docs/conf.py"}]}