docs: user docs updated, mostly for settings page

Author: tdudgeon

pages/docs/assets/project-context.png

@@ -39,7 +39,7 @@ work in and the **Project** you want to work in.
 More details can be found in the [Setting your work context](./how-to/context) How To guide.
 
 
-## The Project tab
+## The Project Data tab
 
 This shows the contents (files and directories) in your project.
 The interface is a simple file browser a bit like Windows Explorer and probably doesn't need much explanation.

pages/docs/assets/project-users.png

@@ -21,11 +21,13 @@ The settings panel opens full screen (close it when finished).
 
 You can select a **context** which includes the **organisation** and **unit** within that **organisation** that you want to
 work in. The administrators of that **organisation** and **unit** will need to have added you as member, or given you access to a
-**project** in the unit. See the [concepts document](/docs/concepts) for a description of
-these concepts.
+**project** in the unit. See the [concepts document](/docs/concepts) for a description of these concepts.
 
 <Image src={projectContext} alt="Project context" />
 
+Also note the *filter* option at the top that allows to filter the projects tht are shown based on your role in the project.
+To see the project you want you may need to adjust this filter.
+
 If you not a member of a **unit** or **project** in a named **organisation** you can still create a **project** in the **Default**
 organisation. In that organisation you will have a **personal** **unit** that has the same name as your username. You can
 select the **Default** Organisation and your personal unit. These personal units are designed primarily for your own
@@ -39,6 +41,7 @@ When you close the settings dialog then you will be working in that **project**,
 
 Owners of an **organisation** can create a new **unit** within it if you want a different work space (e.g. research
 group, department etc.). The **Default** **organisation** cannot have **units** added to it other than a user's
-**personal** unit.
+**personal** unit. The actions you see for managing **organisations**, **units** and **projects** will depend on your
+role in the selected **organisation**, **unit** and **project**.
 
 export default ({ children }) => <Layout><Container>{children}</Container></Layout>

pages/docs/guided-tour.mdx

@@ -23,9 +23,9 @@ This guide deals with the specifics of creating a **new project**.
 A **project** is created within your currently selected **unit**. You can only do this in your own **personal** **unit**
 within the **Default** **organisation** or within a **unit** of another **organisation** if you are an owner of that
 **unit**. The **organisation** owner needs to make you a member of the **unit**. You *do not* need to be a member of
-a **unit** in order to use a **project** in that **unit**. The owner of the **project** can add you as an **editor**
-or the project to give you write access to the **project** and you will have read access to any public projects in the
-unit.
+a **unit** in order to use a **project** in that **unit**. The owner of the **project** can add you as an **administrator**,
+**editor** or **observer** of the project to give you write access to the **project** and you will have **observer** access
+to any public projects in the unit.
 
 The *Create Project* button will be present in the *Context* section of the *Settings panel* if you are able to create a
 project in the current **context**. If you click on this you get a dialog that lets you specify the project details.
@@ -41,10 +41,20 @@ Once you have made your choices click on the CREATE button to create your projec
 Remember that the owner of the **unit** is responsible for the costs of your project. In the case of a **personal unit**
 in the **Default organisation** that means you!
 
-You can add additional users to your project. These can either be as *editor* or *observers*. *Editors* have full access
-to the project, effectively the same rights as you, the *owner*. *Observers* can see the content, but cannot change
-anything and cannot execute jobs. To add users to your project click the edit button in the action to the right of your
-project listing and add the users you want to the *Editors* and *Observers* sections.
+You can add additional users to your project. These can either be as *administrator*, *editor* or *observers*.
+
+The roles are as follows:
+* **creator** - the person who created the project and can perform administrative operations on it.
+  Only this person can delete the project.
+* **administrator** - can administer the project in the same way as it's creator, except that they cannot delete the
+  project. A project can have multiple administrators.
+* **editor** - can use the project and modify the data in it. they can run apps and jobs in the project.
+* **observer** - can view the contents of the project, but cannot make any changes to the data or execute apps or jobs.
+
+To add or remove users to your project click the edit button in the action to the right of your
+project listing and add the users you want to the *Administrators*, *Editors* and *Observers* sections.
+You can also change the privacy of the project with this dialog.
+
 
 <Image src={users} alt="Edit project dialog" />
 

pages/docs/how-to/context.mdx

@@ -15,7 +15,7 @@ import { DocsNav } from "../../../components/DocsNav";
 Your project has it's own data volume (a directory containing your projects files).
 That volume is accessible to any jobs and applications, providing a simple way to work with your data.
 
-The *Project* tab allows you to see that data and perform simple operations on it.
+The *Project Data* tab allows you to see that data and perform simple operations on it.
 It's a bit like a simple file manager like Windows Explorer. It lists the files and directories that are present and
 allows to navigate that data.
 
@@ -24,11 +24,12 @@ You an also:
 - upload new files to your project
 - download files from your project
 - delete existing files
+- create and delete directories
 - create a dataset from a file (see documentation on Datasets)
 - mark a file as a "favourite" to make is faster to access when running jobs
 - view the contents of text files
 
-Not all operations you might want to do are possible from the *Project* tab.
+Not all operations you might want to do are possible from the *Project Data* tab.
 If you want to do more then your best bet is to launch the Jupyter Lab application in your project. That will allow you
 to manage your files either with the Jupyter Lab file manager or by opening up a console (bash shell).
 See the [Running applications](./applications) How To guide for more details on launching

pages/docs/how-to/create-project.mdx

@@ -23,7 +23,8 @@ The best starting point to find out about the usage and costs of your projects i
 
 This lets you look at all the projects in a particular using and see a high level summary of the usage stats.
 You will see information for:
-* The project owner
+* Whether the project is public or private
+* The project creator and administrators
 * The project tier (evaluation, bronze, silver or gold)
 * A bar graph showing usage costs (see below for an explanation)
 * The number of instances used
@@ -39,7 +40,7 @@ The usage bar shows your consumption in Squonk coins (or coins for short) and is
 4. Green - coins predicted not to be consumed till the end of the month, assuming your storage does not change and you
    run no more applications or jobs.
 
-If you move the mouse over one of these ba graphs then a more detailed listing of that usage is presented.
+If you move the mouse over one of these bar graphs then a more detailed listing of that usage is presented.
 
 ### Project charges