Browse Source

Doc edits of the “Getting started” section.

Jason Grout 7 years ago
parent
commit
85d9874593

+ 5 - 6
docs/source/getting_started/installation.md

@@ -26,11 +26,10 @@ jupyter notebook --version
 
 ## Supported browsers
 
-The following browsers are currently *known to work*:
+The following browsers are currently known to work:
 
-- Firefox Latest
-- Chrome Latest
-- Safari Latest
+- Firefox (latest version)
+- Chrome (latest version)
+- Safari (latest version)
 
-Earlier browser versions or other browsers may also work, but come with no
-guarantees.
+Earlier browser versions or other browsers may also work, but may not be tested.

+ 14 - 19
docs/source/getting_started/overview.md

@@ -6,30 +6,25 @@ JupyterLab goes beyond the classic Jupyter Notebook by providing a flexible and
 extensible web application with a set of reusable components. You can arrange
 multiple notebooks, text editors, terminals, output areas, and custom components
 using tabs/panels and collapsible sidebars. These components are carefully
-designed to enable you to use them together (can send code from a file to a code
-console with a keystroke) or on their own (move cells around a notebook using
-drag-and-drop) to support novel data-driven workflows.
+designed to enable you to use them together or on their own to support new
+workflows (for example, you can send code from a file to a code console with a
+keystroke, or move cells around a notebook or between notebooks with
+drag-and-drop).
 
 **JupyterLab has full support for Jupyter Notebook documents.** In addition, it
-offers other models of interactive computing:
+enables other models of interactive computing, such as:
 
 * [Code Consoles]() provide transient scratchpads for running code
   interactively, with full support for rich output.
-* [Kernel backed documents]() allow code in any text file (markdown, python, R,
+* [Kernel-backed documents]() allow code in any text file (Markdown, Python, R,
   LaTeX, etc.) to be run interactively in any Jupyter kernel.
 
-JupyterLab also offers a unified model for handling rich output and various file
-formats. This allows data in just about any format (images, CSV, JSON, markdown,
-PDF, Vega, Vega-Lite, etc.) to be opened as a file, or returned by a Kernel as
-output. See [File and output formats]() for more information.
-
-## Design principles
-
-JupyterLab should:
-
-* Use the same [server](https://jupyter-notebook.readthedocs.io/en/stable/) as
-  the classic Jupyter Notebook.
-* Use the same [notebook document
-  format](http://nbformat.readthedocs.io/en/latest/) as the classic Jupyter
-  Notebook.
+JupyterLab also offers a unified model for viewing and handling data formats.
+This allows data in many formats (images, CSV, JSON, Markdown, PDF, Vega,
+Vega-Lite, etc.) to be opened as a file or returned by a kernel as rich output.
+See [File and output formats]() for more information.
 
+JupyterLab is served from the same
+[server](https://jupyter-notebook.readthedocs.io/en/stable/) and uses the same
+[notebook document format](http://nbformat.readthedocs.io/en/latest/) as the
+classic Jupyter Notebook.

+ 9 - 10
docs/source/getting_started/starting.md

@@ -7,19 +7,18 @@ jupyter lab
 ```
 
 JupyterLab will open automatically in your browser. You may also access
-JupyterLab by entering the notebook server's URL (`http://localhost:8888`) into
-the browser.
+JupyterLab by entering the notebook server's URL (usually
+`http://localhost:8888`) into the browser. You can also open the classic
+Notebook from JupyterLab by selecting "Launch Classic Notebook" from the
+JupyterLab Help menu.
 
 Because JupyterLab is a server extension of the classic Jupyter Notebook server,
-you can also use JupyterLab by starting the classic Jupyter Noteboook `jupyter
-notebook` and visiting the `/lab` URL (`http://localhost:8888/lab`) rather than
-`/tree` (`http://localhost:8888/tree`).
-
-Anytime you are using JupyterLab, the classic Jupyter Notebook is still
-available at this `/tree` URL (`http://localhost:8888/tree`), which makes it
-easy to go back and forth if needed.
+you can also use JupyterLab by starting the classic Jupyter Noteboook
+(`jupyter notebook`) and visiting the `/lab` URL (usually `http://localhost:8888/lab`)
+rather than the default `/tree` URL. Conversely, to go to the classic Notebook
+from JupyterLab, you can change the URL from `/lab` to `/tree`.
 
 JupyterLab has the same security model as the classic Jupyter Notebook; for more
 information see the [security
 section](https://jupyter-notebook.readthedocs.io/en/stable/security.html) of the
-classic Notebook's documentation.
+classic Notebook's documentation.