prompt: We are currently solving the following issue within our repository. Here is the issue text:
  --- BEGIN ISSUE ---
  improve contribution instructions and expose in the docs
  #### Location of the documentation
  
  NA
  
  #### Documentation problem
  
  Currently, the contribution documentation is in [github](https://github.com/pandera-dev/pandera/blob/master/.github/CONTRIBUTING.md) but it would be nice to also expose it in the online documentation.
  
  Additionally, we also want to document the process of contributing:
  
  Enhancements (New features)
  - create a `feature/<my-feature>` or `feature/<issue-number>` branch
  - make a pull request to `dev`
  
  Bugs
  - create a `bugfix/<my-fix>` or `bugfix/<issue-number>` branch
  - make a pull request to `master`
  
  Docs
  - create a `docs/<my-docs>` or `docs/<issue-number>` branch
  - make a pull request to `master`
  
  --- 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/source/conf.py`
  Content:
  ```
  1 # Configuration file for the Sphinx documentation builder.
  2 #
  3 # This file only contains a selection of the most common options. For a full
  4 # list see the documentation:
  5 # http://www.sphinx-doc.org/en/master/config
  6 
  7 # -- Path setup --------------------------------------------------------------
  8 
  9 import doctest
  10 import logging as pylogging
  11 
  12 # If extensions (or modules to document with autodoc) are in another directory,
  13 # add these directories to sys.path here. If the directory is relative to the
  14 # documentation root, use os.path.abspath to make it absolute, like shown here.
  15 #
  16 import os
  17 import sys
  18 
  19 from sphinx.util import logging
  20 
  21 sys.path.insert(0, os.path.abspath("../../pandera"))
  22 
  23 
  24 # -- Project information -----------------------------------------------------
  25 
  26 project = "pandera"
  27 copyright = "2019, Niels Bantilan, Nigel Markey, Jean-Francois Zinque"
  28 author = "Niels Bantilan, Nigel Markey, Jean-Francois Zinque"
  29 
  30 
  31 # -- General configuration ---------------------------------------------------
  32 
  33 # Add any Sphinx extension module names here, as strings. They can be
  34 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
  35 # ones.
  36 extensions = [
  37     "sphinx.ext.autodoc",
  38     "sphinx.ext.autosummary",
  39     "sphinx.ext.intersphinx",
  40     "sphinx.ext.doctest",
  41     "sphinx_autodoc_typehints",
  42     "sphinx.ext.viewcode",
  43 ]
  44 
  45 doctest_global_setup = """
  46 import sys
  47 import pandas as pd
  48 import numpy as np
  49 from packaging import version
  50 pd.options.display.max_columns = None # For Travis on macOS
  51 pd.options.display.max_rows = None # For Travis on macOS
  52 
  53 try:
  54     import hypothesis
  55 except ImportError:
  56     SKIP_STRATEGY = True
  57 else:
  58     SKIP_STRATEGY = False
  59 
  60 SKIP = sys.version_info < (3, 6)
  61 PY36 = sys.version_info < (3, 7)
  62 SKIP_PANDAS_LT_V1 = version.parse(pd.__version__).release < (1, 0) or PY36
  63 """
  64 
  65 doctest_default_flags = (
  66     0
  67     | doctest.DONT_ACCEPT_TRUE_FOR_1
  68     | doctest.ELLIPSIS
  69     | doctest.IGNORE_EXCEPTION_DETAIL
  70     | doctest.NORMALIZE_WHITESPACE
  71 )
  72 
  73 # Add any paths that contain templates here, relative to this directory.
  74 templates_path = ["_templates"]
  75 
  76 # The master toctree document.
  77 master_doc = "index"
  78 
  79 # List of patterns, relative to source directory, that match files and
  80 # directories to ignore when looking for source files.
  81 # This pattern also affects html_static_path and html_extra_path.
  82 exclude_patterns = []
  83 
  84 autoclass_content = "both"
  85 pygments_style = None
  86 
  87 autodoc_default_options = {
  88     # 'special-members': '__call__',
  89     "undoc-members": False,
  90     # 'exclude-members': '__weakref__'
  91 }
  92 
  93 # -- Options for HTML output -------------------------------------------------
  94 
  95 # The theme to use for HTML and HTML Help pages.  See the documentation for
  96 # a list of builtin themes.
  97 #
  98 html_theme = "sphinx_rtd_theme"
  99 
  100 # Theme options are theme-specific and customize the look and feel of a theme
  101 # further.  For a list of options available for each theme, see the
  102 # documentation.
  103 
  104 html_logo = "_static/pandera-banner-white.png"
  105 html_theme_options = {
  106     "collapse_navigation": False,
  107     "logo_only": True,
  108     "analytics_id": "UA-71018060-2",
  109 }
  110 
  111 # Add any paths that contain custom static files (such as style sheets) here,
  112 # relative to this directory. They are copied after the builtin static files,
  113 # so a file named "default.css" will overwrite the builtin "default.css".
  114 html_static_path = ["_static"]
  115 
  116 rst_prolog = """
  117 .. role:: red
  118 .. role:: green
  119 """
  120 
  121 autosummary_generate = ["API_reference.rst"]
  122 autosummary_filename_map = {
  123     "pandera.Check": "pandera.Check",
  124     "pandera.check": "pandera.check_decorator",
  125 }
  126 
  127 intersphinx_mapping = {
  128     "python": ("https://docs.python.org/3/", None),
  129     "numpy": ("https://docs.scipy.org/doc/numpy/", None),
  130     "pandas": ("http://pandas.pydata.org/pandas-docs/stable/", None),
  131 }
  132 
  133 
  134 # this is a workaround to filter out forward reference issue in
  135 # sphinx_autodoc_typehints
  136 class FilterPandasTypeAnnotationWarning(pylogging.Filter):
  137     def filter(self, record: pylogging.LogRecord) -> bool:
  138         # You probably should make this check more specific by checking
  139         # that dataclass name is in the message, so that you don't filter out
  140         # other meaningful warnings
  141         return not record.getMessage().startswith(
  142             "Cannot resolve forward reference in type annotations of "
  143             '"pandera.typing.DataFrame"'
  144         )
  145 
  146 
  147 logging.getLogger("sphinx_autodoc_typehints").logger.addFilter(
  148     FilterPandasTypeAnnotationWarning()
  149 )
  150 
  151 
  152 def setup(app):
  153     app.add_css_file("default.css")
  154
  ```
  --- 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/source/conf.py b/docs/source/conf.py
  --- a/docs/source/conf.py
  +++ b/docs/source/conf.py
  @@ -14,6 +14,7 @@
   # documentation root, use os.path.abspath to make it absolute, like shown here.
   #
   import os
  +import shutil
   import sys
   
   from sphinx.util import logging
  @@ -40,6 +41,7 @@
       "sphinx.ext.doctest",
       "sphinx_autodoc_typehints",
       "sphinx.ext.viewcode",
  +    "recommonmark",
   ]
   
   doctest_global_setup = """
  @@ -70,6 +72,19 @@
       | doctest.NORMALIZE_WHITESPACE
   )
   
  +source_suffix = {
  +    ".rst": "restructuredtext",
  +    ".md": "markdown",
  +}
  +
  +# copy CONTRIBUTING.md docs into source directory
  +shutil.copyfile(
  +    os.path.join(
  +        os.path.dirname(__file__), "..", "..", ".github", "CONTRIBUTING.md"
  +    ),
  +    "CONTRIBUTING.md",
  +)
  +
   # Add any paths that contain templates here, relative to this directory.
   templates_path = ["_templates"]
  
verification_info: {"golden_diff": "diff --git a/docs/source/conf.py b/docs/source/conf.py\n--- a/docs/source/conf.py\n+++ b/docs/source/conf.py\n@@ -14,6 +14,7 @@\n # documentation root, use os.path.abspath to make it absolute, like shown here.\n #\n import os\n+import shutil\n import sys\n \n from sphinx.util import logging\n@@ -40,6 +41,7 @@\n     \"sphinx.ext.doctest\",\n     \"sphinx_autodoc_typehints\",\n     \"sphinx.ext.viewcode\",\n+    \"recommonmark\",\n ]\n \n doctest_global_setup = \"\"\"\n@@ -70,6 +72,19 @@\n     | doctest.NORMALIZE_WHITESPACE\n )\n \n+source_suffix = {\n+    \".rst\": \"restructuredtext\",\n+    \".md\": \"markdown\",\n+}\n+\n+# copy CONTRIBUTING.md docs into source directory\n+shutil.copyfile(\n+    os.path.join(\n+        os.path.dirname(__file__), \"..\", \"..\", \".github\", \"CONTRIBUTING.md\"\n+    ),\n+    \"CONTRIBUTING.md\",\n+)\n+\n # Add any paths that contain templates here, relative to this directory.\n templates_path = [\"_templates\"]\n", "issue": "improve contribution instructions and expose in the docs\n#### Location of the documentation\r\n\r\nNA\r\n\r\n#### Documentation problem\r\n\r\nCurrently, the contribution documentation is in [github](https://github.com/pandera-dev/pandera/blob/master/.github/CONTRIBUTING.md) but it would be nice to also expose it in the online documentation.\r\n\r\nAdditionally, we also want to document the process of contributing:\r\n\r\nEnhancements (New features)\r\n- create a `feature/<my-feature>` or `feature/<issue-number>` branch\r\n- make a pull request to `dev`\r\n\r\nBugs\r\n- create a `bugfix/<my-fix>` or `bugfix/<issue-number>` branch\r\n- make a pull request to `master`\r\n\r\nDocs\r\n- create a `docs/<my-docs>` or `docs/<issue-number>` branch\r\n- make a pull request to `master`\n", "before_files": [{"content": "# Configuration file for the Sphinx documentation builder.\n#\n# This file only contains a selection of the most common options. For a full\n# list see the documentation:\n# http://www.sphinx-doc.org/en/master/config\n\n# -- Path setup --------------------------------------------------------------\n\nimport doctest\nimport logging as pylogging\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\n\nfrom sphinx.util import logging\n\nsys.path.insert(0, os.path.abspath(\"../../pandera\"))\n\n\n# -- Project information -----------------------------------------------------\n\nproject = \"pandera\"\ncopyright = \"2019, Niels Bantilan, Nigel Markey, Jean-Francois Zinque\"\nauthor = \"Niels Bantilan, Nigel Markey, Jean-Francois Zinque\"\n\n\n# -- General configuration ---------------------------------------------------\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.autosummary\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.doctest\",\n    \"sphinx_autodoc_typehints\",\n    \"sphinx.ext.viewcode\",\n]\n\ndoctest_global_setup = \"\"\"\nimport sys\nimport pandas as pd\nimport numpy as np\nfrom packaging import version\npd.options.display.max_columns = None # For Travis on macOS\npd.options.display.max_rows = None # For Travis on macOS\n\ntry:\n    import hypothesis\nexcept ImportError:\n    SKIP_STRATEGY = True\nelse:\n    SKIP_STRATEGY = False\n\nSKIP = sys.version_info < (3, 6)\nPY36 = sys.version_info < (3, 7)\nSKIP_PANDAS_LT_V1 = version.parse(pd.__version__).release < (1, 0) or PY36\n\"\"\"\n\ndoctest_default_flags = (\n    0\n    | doctest.DONT_ACCEPT_TRUE_FOR_1\n    | doctest.ELLIPSIS\n    | doctest.IGNORE_EXCEPTION_DETAIL\n    | doctest.NORMALIZE_WHITESPACE\n)\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\n# The master toctree document.\nmaster_doc = \"index\"\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 = []\n\nautoclass_content = \"both\"\npygments_style = None\n\nautodoc_default_options = {\n    # 'special-members': '__call__',\n    \"undoc-members\": False,\n    # 'exclude-members': '__weakref__'\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 = \"sphinx_rtd_theme\"\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_logo = \"_static/pandera-banner-white.png\"\nhtml_theme_options = {\n    \"collapse_navigation\": False,\n    \"logo_only\": True,\n    \"analytics_id\": \"UA-71018060-2\",\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\nrst_prolog = \"\"\"\n.. role:: red\n.. role:: green\n\"\"\"\n\nautosummary_generate = [\"API_reference.rst\"]\nautosummary_filename_map = {\n    \"pandera.Check\": \"pandera.Check\",\n    \"pandera.check\": \"pandera.check_decorator\",\n}\n\nintersphinx_mapping = {\n    \"python\": (\"https://docs.python.org/3/\", None),\n    \"numpy\": (\"https://docs.scipy.org/doc/numpy/\", None),\n    \"pandas\": (\"http://pandas.pydata.org/pandas-docs/stable/\", None),\n}\n\n\n# this is a workaround to filter out forward reference issue in\n# sphinx_autodoc_typehints\nclass FilterPandasTypeAnnotationWarning(pylogging.Filter):\n    def filter(self, record: pylogging.LogRecord) -> bool:\n        # You probably should make this check more specific by checking\n        # that dataclass name is in the message, so that you don't filter out\n        # other meaningful warnings\n        return not record.getMessage().startswith(\n            \"Cannot resolve forward reference in type annotations of \"\n            '\"pandera.typing.DataFrame\"'\n        )\n\n\nlogging.getLogger(\"sphinx_autodoc_typehints\").logger.addFilter(\n    FilterPandasTypeAnnotationWarning()\n)\n\n\ndef setup(app):\n    app.add_css_file(\"default.css\")\n", "path": "docs/source/conf.py"}], "after_files": [{"content": "# Configuration file for the Sphinx documentation builder.\n#\n# This file only contains a selection of the most common options. For a full\n# list see the documentation:\n# http://www.sphinx-doc.org/en/master/config\n\n# -- Path setup --------------------------------------------------------------\n\nimport doctest\nimport logging as pylogging\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 shutil\nimport sys\n\nfrom sphinx.util import logging\n\nsys.path.insert(0, os.path.abspath(\"../../pandera\"))\n\n\n# -- Project information -----------------------------------------------------\n\nproject = \"pandera\"\ncopyright = \"2019, Niels Bantilan, Nigel Markey, Jean-Francois Zinque\"\nauthor = \"Niels Bantilan, Nigel Markey, Jean-Francois Zinque\"\n\n\n# -- General configuration ---------------------------------------------------\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.autosummary\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.doctest\",\n    \"sphinx_autodoc_typehints\",\n    \"sphinx.ext.viewcode\",\n    \"recommonmark\",\n]\n\ndoctest_global_setup = \"\"\"\nimport sys\nimport pandas as pd\nimport numpy as np\nfrom packaging import version\npd.options.display.max_columns = None # For Travis on macOS\npd.options.display.max_rows = None # For Travis on macOS\n\ntry:\n    import hypothesis\nexcept ImportError:\n    SKIP_STRATEGY = True\nelse:\n    SKIP_STRATEGY = False\n\nSKIP = sys.version_info < (3, 6)\nPY36 = sys.version_info < (3, 7)\nSKIP_PANDAS_LT_V1 = version.parse(pd.__version__).release < (1, 0) or PY36\n\"\"\"\n\ndoctest_default_flags = (\n    0\n    | doctest.DONT_ACCEPT_TRUE_FOR_1\n    | doctest.ELLIPSIS\n    | doctest.IGNORE_EXCEPTION_DETAIL\n    | doctest.NORMALIZE_WHITESPACE\n)\n\nsource_suffix = {\n    \".rst\": \"restructuredtext\",\n    \".md\": \"markdown\",\n}\n\n# copy CONTRIBUTING.md docs into source directory\nshutil.copyfile(\n    os.path.join(\n        os.path.dirname(__file__), \"..\", \"..\", \".github\", \"CONTRIBUTING.md\"\n    ),\n    \"CONTRIBUTING.md\",\n)\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\n# The master toctree document.\nmaster_doc = \"index\"\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 = []\n\nautoclass_content = \"both\"\npygments_style = None\n\nautodoc_default_options = {\n    # 'special-members': '__call__',\n    \"undoc-members\": False,\n    # 'exclude-members': '__weakref__'\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 = \"sphinx_rtd_theme\"\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_logo = \"_static/pandera-banner-white.png\"\nhtml_theme_options = {\n    \"collapse_navigation\": False,\n    \"logo_only\": True,\n    \"analytics_id\": \"UA-71018060-2\",\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\nrst_prolog = \"\"\"\n.. role:: red\n.. role:: green\n\"\"\"\n\nautosummary_generate = [\"API_reference.rst\"]\nautosummary_filename_map = {\n    \"pandera.Check\": \"pandera.Check\",\n    \"pandera.check\": \"pandera.check_decorator\",\n}\n\nintersphinx_mapping = {\n    \"python\": (\"https://docs.python.org/3/\", None),\n    \"numpy\": (\"https://docs.scipy.org/doc/numpy/\", None),\n    \"pandas\": (\"http://pandas.pydata.org/pandas-docs/stable/\", None),\n}\n\n\n# this is a workaround to filter out forward reference issue in\n# sphinx_autodoc_typehints\nclass FilterPandasTypeAnnotationWarning(pylogging.Filter):\n    def filter(self, record: pylogging.LogRecord) -> bool:\n        # You probably should make this check more specific by checking\n        # that dataclass name is in the message, so that you don't filter out\n        # other meaningful warnings\n        return not record.getMessage().startswith(\n            \"Cannot resolve forward reference in type annotations of \"\n            '\"pandera.typing.DataFrame\"'\n        )\n\n\nlogging.getLogger(\"sphinx_autodoc_typehints\").logger.addFilter(\n    FilterPandasTypeAnnotationWarning()\n)\n\n\ndef setup(app):\n    app.add_css_file(\"default.css\")\n", "path": "docs/source/conf.py"}]}