Browse Source

Edits for the files interface doc page.

Jason Grout 7 years ago
parent
commit
a3bf09c7d7
1 changed files with 25 additions and 25 deletions
  1. 25 25
      docs/source/user/files.md

+ 25 - 25
docs/source/user/files.md

@@ -1,13 +1,13 @@
 
 # Working with files
 
-## Overview
+## Opening files
 
-The File Browser and File menu allow you to work with files and directories on
-your system. This includes opening, creating, deleting, renaming, downloading,
-copying and sharing files and directories.
+The file browser and File menu allow you to work with
+files and directories on your system. This includes opening, creating, deleting,
+renaming, downloading, copying, and sharing files and directories.
 
-The File Browser is in the Left Panel (the Files tab):
+The file browser is in the left sidebar Files tab:
 
 [screenshot]
 
@@ -15,18 +15,19 @@ Many actions on files can also be carried out in the File menu:
 
 [screenshot]
 
-To open any file double-click on its name in the File Browser:
+To open any file, double-click on its name in the file browser:
 
 [animation]
 
-You can also drag a file into the Dock Panel:
+You can also drag a file into the main area to create a new tab:
 
 [animation]
 
-Many files types have multiple viewers/editors. For example, you can open a
-markdown file in the text editor, or as rendered markdown. To open a file in a
-non-default viewer/editor, right-click on its name in the File Browser, and use
-the "Open With..." submenu to select the viewer/editor:
+Many files types have multiple viewers/editors. For example, you can open a Markdown file in
+a text editor or as rendered HTML. A JupyterLab extension can also
+add new viewers/editors for files. To open a file in a non-default
+viewer/editor, right-click on its name in the file browser and use the "Open
+With..." submenu to select the viewer/editor:
 
 [animation]
 
@@ -35,42 +36,41 @@ will remain in sync:
 
 [animation]
 
-The file system can be navigated by double clicking on folders, or on the
-directories at the top of the directory listing:
+The file system can be navigated by double clicking on folders in the listing or
+clicking on the folders at the top of the directory listing:
 
 [animation]
 
-Each file or directory in JupyterLab also has a URL that can used to open
-JupyterLab with that file or directory open. To get the shareable link,
-right-click on the file or directory and select the "Copy Shareable Link" item:
+Right-click on a file or directory and select "Copy Shareable Link" to copy a
+URL that can be used to open JupyterLab with that file or directory open.
 
 [screenshot]
 
 ## Creating files and activities
 
-Create new files or activities by clicking the + button at the top of the File
-Browser. This will open the Launcher in the Dock Panel, which allows you to pick
+Create new files or activities by clicking the `+` button at the top of the file
+browser. This will open a new Launcher tab in the main area, which allows you to pick
 an activity and kernel:
 
 [animation]
 
-You can also create new documents or activities using the File Menu:
+You can also create new documents or activities using the File menu:
 
 [screenshot]
 
-The current working directory of the Launcher will follow that of the File
-Browser:
+The current working directory of a new activity or document will be the directory listed in the file browser (except for a terminal, which always starts in the root directory of the file browser):
 
 [animation]
 
 ## Uploading and downloading
 
-Files can be uploaded to the current directory of the File Browser by dragging
-and dropping files onto the File Browser:
+Files can be uploaded to the current directory of the file browser by dragging
+and dropping files onto the file browser, or by clicking the "Upload Files"
+button at the top of the file browser:
 
 [animation]
 
-Any file in JupyterLab can be downloaded by clicking on the “Download” button at
-the top of the File Browser:
+Any file in JupyterLab can be downloaded by right-clicking its name in the file
+browser and selecting “Download” from the context menu:
 
 [animation]