Buttonify support page and clean up about page (#260)

Co-authored-by: Simon Li <orpheus+devel@gmail.com>
jupyterhub · May 2, 2022 · 444bc6a · 444bc6a
1 parent 564db1f
commit 444bc6a
Show file tree

Hide file tree

Showing 16 changed files with 352 additions and 394 deletions.
diff --git a/doc/_static/custom.css b/doc/_static/custom.css
@@ -4,8 +4,17 @@
 }
 
 /* Header */
-i.fa.fa-heart {
-    color: #e66783;
+
+.support-button {
+    background-color: #e66783;
+}
+
+.support-button:hover {
+    background-color: #b9556b;
+}
+
+.support-button i {
+    padding-right: .5em;
 }
 
 /* Text elements */

diff --git a/doc/_templates/support-button.html b/doc/_templates/support-button.html
@@ -0,0 +1 @@
+<a class="btn btn-secondary support-button" href="https://mybinder.readthedocs.io/en/latest/about/support.html" role="button"><i class="fas fa-heart"></i>Support Binder</a>
diff --git a/doc/about/cite.md b/doc/about/cite.md
@@ -0,0 +1,17 @@
+(about:citing)=
+# Cite Binder
+
+If you publish work that uses Binder, please consider citing the
+[Binder paper from the 2018 SciPy proceedings](http://conference.scipy.org/proceedings/scipy2018/project_jupyter.html).
+
+Here is a citation that you can use:
+
+```
+Jupyter et al., "Binder 2.0 - Reproducible, Interactive, Sharable
+Environments for Science at Scale." Proceedings of the 17th Python
+in Science Conference. 2018. doi://10.25080/Majora-4af1f417-011
+```
+
+And here is a DOI for you to use:
+
+[10.25080/Majora-4af1f417-011](https://doi.org/10.25080/Majora-4af1f417-011)
diff --git a/doc/about/contribute.md b/doc/about/contribute.md
@@ -1,4 +1,4 @@
-# Contribute
+# Join and contribute
 
 There are many ways that you can contribute to the Binder project, and the Binder community welcomes any and all contributions that others are willing to give.
 

diff --git a/doc/about/faq.rst b/doc/about/faq.rst
diff --git a/doc/about/index.md b/doc/about/index.md
@@ -1,14 +1,20 @@
 # About mybinder.org
 
-This is a collection of pages about the Binder service running at mybinder.org.
+The Binder Project is an open community that makes it possible to create sharable,
+interactive, reproducible environments. The main technical product that
+the community creates is called BinderHub, which you can try out
+at [`mybinder.org`](https://mybinder.org). 
+
+This is a collection of pages about the Binder service running at [mybinder.org](https://mybinder.org), covering things like what to expect when using mybinder.org, who runs the service, and how you can support it.
 
 ```{toctree}
-:maxdepth: 1
+:maxdepth: 2
 
 user-guidelines
-faq
+status
 support
+team
 contribute
 federation
-status
+cite
 ```
diff --git a/doc/about/status.rst b/doc/about/status.rst
@@ -1,5 +1,5 @@
-Status page
-===========
+mybinder.org status
+===================
 
 This page displays several graphics that give an idea for the current
 status of the `mybinder.org <https://mybinder.org>`_ service. You can find