addressing review comments

Author: choldgraf

doc/about/user-guidelines.md

@@ -45,31 +45,27 @@ We don't want a single repository to dominate all of the traffic to Binder, so
 we've set a maximum limit of concurrent user sessions that point to the same
 Binder link. **The maximum number of simultaneous users for a given repo is 100**.
 If you think you have a *really* good reason for why this number should be
-higher, please [Open an Issue](https://github.com/jupyterhub/mybinder.org-deploy/issues).
+higher, please [Open an Issue](https://github.com/jupyterhub/mybinder.org-deploy/issues/new?labels=impact&template=request_resources.md).
 to discuss with the community!
 
 ## Using mybinder.org as backend for your service
 
-Please do not use mybinder.org as backend for your for-profit service or product.
+:::{admonition,warning} A note on for-profit services
+Please do not use `mybinder.org` as backend for your for-profit service or product.
 
-The cloud resources consumed by mybinder.org are funded through donations or grants. Because
-of this we can not subsidise for-profit products or services by offering free cloud resources to them.
-This means we will prevent you from using mybinder.org as a service for your product.
+The cloud resources consumed by `mybinder.org` are funded through donations or grants. Because of this we can not subsidise for-profit products or services by offering free cloud resources to them. This means we will prevent you from using `mybinder.org` as a service for your product.
 
-Operating mybinder.org relies on the good will of volunteers and organisations to obtain the
+Operating `mybinder.org` relies on the good will of volunteers and organisations to obtain the
 resources required to do so. This is easier if we are not seen as supporting for-profit services
 that are not a net contributor to the service.
+:::
+
+You may be considering using `mybinder.org` as a part of your service or product. We think that is great, and encourage people to experiment with using Binder technology as a part of their tools.
 
-You may be considering using `mybinder.org` as a part of your service or product.
-Think that is great, and encourage people to experiment with using Binder technology
-as a part of their tools.
+However, depending on the size and consistency of traffic being directed at `mybinder.org`, we may restrict your usage of the `mybinder.org` service in order to avoid being overloaded by a single user / organization. This is particularly true for services that trigger many **repository builds**.
 
-However, depending on the size and consistency of traffic being directed at `mybinder.org`,
-we may restrict your usage of the `mybinder.org` service in order to avoid being overloaded
-by a single user / organization. This is particularly true for services that trigger many **repository builds**.
+In general, please be respectful of the Binder Project's limited resources. Do not forget that it has no dedicated funding and runs entirely on donations of cloud resources. If you have a question about this, please [Open an Issue](https://github.com/jupyterhub/mybinder.org-deploy/issues/new?labels=impact&template=request_resources.md).
 
-In general, please be respectful of the Binder Project's limited resources. Do not forget
-that it has no dedicated funding and runs entirely on donations of cloud resources.
 
 ## Reporting Abuse
 

doc/conf.py

@@ -20,7 +20,12 @@ def setup(app):
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["sphinx_copybutton", "myst_parser", "sphinx_panels"]
+extensions = [
+    "sphinx_copybutton",
+    "myst_parser",
+    "sphinx_panels",
+    "sphinxext.rediraffe",
+]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -100,6 +105,21 @@ def setup(app):
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["_static"]
 
+rediraffe_redirects = {
+    "faq.rst": "using/faq.md",
+    "about.rst": "about/index.md",
+    "examples.rst": "examples/examples.md",
+    "index-repo-reference.rst": "examples/index.rst",
+    "sample_repos.md": "examples/sample_repos.md",
+    "index-community.rst": "about/index.md",
+    "index-getting-started.rst": "introduction.md",
+    "more-info.rst": "using/faq.md",
+    "reliability.rst": "about/status.rst",
+    "status.rst": "about/status.rst",
+    "user-guidelines.rst": "about/user-guidelines.md",
+    "using.rst": "using/using.rst",
+}
+
 # -- MyST Configuration ------------------------------------------
 # See https://myst-parser.readthedocs.io/en/latest/using/syntax-optional.html#definition-lists
 myst_admonition_enable = True