Browse Source

first pass at putting it together

jd41 4 years ago
parent
commit
603151bcab
1 changed files with 12 additions and 7 deletions
  1. 12 7
      docs/source/developer/contributing.rst

+ 12 - 7
docs/source/developer/contributing.rst

@@ -84,21 +84,26 @@ issues with labels using the ``@meeseeksdev`` bot. For example: To apply
 the label ``foo`` and ``bar baz`` to an issue, comment
 ``@meeseeksdev tag foo "bar baz"`` on the issue.
 
-Proposing and testing changes within the browser
-------------------------------------------------
+Contributing from within the browser
+------------------------------------
 Using the `github.com <https://github.com>` web interface - which is
 documented `here <https://docs.github.com/en/free-pro-team@latest/github>` if you
 run into problems - you can create and propose a change purely within your browser.
 
-You can launch a binder with the latest JupyterLab master to test
-something (this takes about 7 minutes):
+Using `Binder <https://mybinder.org>`, you can test your changes within the browser
+as well. We recommend you have at least 8 GB of RAM for this.
+
+To build and launch an instance of the latest JupyterLab master,
+open a new tab with the following link:
 
 .. image:: https://mybinder.org/badge_logo.svg
    :target: https://mybinder.org/v2/gh/jupyterlab/jupyterlab/master?urlpath=lab-dev/
-   
+
+The build takes about 7 minutes to complete.
+
 If you want to test your own branch hosted on GitHub, just enter it on https://mybinder.org.
-If everything goes right, filling out the form takes about 2 minutes, and the build takes about 7 minutes 
-to complete.
+If everything goes right, filling out the form takes about 2 minutes, and the build should take
+about 7 minutes again.
 
 Installing Node.js and jlpm
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^