some link tidying

README.md

@@ -10,7 +10,7 @@ You can find detailed theme instructions in the [mkdodcs material site](https://
 pip install plantuml-markdown 
 ```
 
-https://github.com/neurobin/mdx_include - proper extension structure -> https://github.com/mikitex70/plantuml-markdown need that doing...
+https://github.com/neurobin/mdx_include - proper extension structure -> https://github.com/mikitex70/plantuml-markdown need that doing... https://python-markdown.github.io/extensions/api/
 
 ## Running the website locally
 

docs/Observer/Creating Proposals/adding-targets.md

@@ -41,6 +41,6 @@ to build an **Observation** for your proposal.
 
 ## Next Step
 
-If you haven't already added a **Technical Goal** then please follow the guide [here](../adding-technical-goals).
+If you haven't already added a **Technical Goal** then please follow the guide [here](adding-technical-goals.md).
 If you have now added at least one **Target** and one **Technical Goal** to your proposal then please 
-follow the link to [**Building Observations**](../build-observation).
+follow the link to [**Building Observations**](build-observation.md).

docs/Observer/Creating Proposals/adding-technical-goals.md

@@ -39,6 +39,6 @@ similar _Performance Parameters_ and/or _Spectral Windows_ without having to re-
 
 ## Next Step
 
-If you haven't already added a **Target** then please follow the guide [here](../adding-targets).
+If you haven't already added a **Target** then please follow the guide [here](adding-targets.md).
 If you have now added at least one **Target** and one **Technical Goal** to your proposal then please follow the
-link to [**Building Observations**](../build-observation).
+link to [**Building Observations**](build-observation.md).

docs/Observer/Creating Proposals/build-observation.md

@@ -56,4 +56,4 @@ you will also have to provide both **Scientific** and **Technical Justifications
 it is likely more things will be added to the validation check in the future.
 
 To see how to submit your proposal for review please follow the guide at 
-[**Submitting Proposals**](../../submitting-proposals)
+[**Submitting Proposals**](../Submitting%20Proposals/index.md)

docs/Observer/Creating Proposals/index.md

@@ -1,7 +1,7 @@
 
 ## First, Login
 
-If you haven't registered with and logged-in to Polaris please do so [now](tbc).
+If you haven't registered with and logged-in to Polaris please do so [now](https://kilburn.jb.man.ac.uk/pst/gui/tool/).
 
 ##  Click the **Create a new proposal** button
 

docs/Observer/index.md

@@ -1,37 +1,9 @@
----
-title: Getting Started
-description: Prerequisites, Installation, and Core Setup
-categories: [Examples, Placeholders]
-tags: [test, docs]
-weight: 2
----
+# Tools for Observers
 
-## Prerequisites
+Observers will mostly interact with Polaris via the [web based GUI](../prototype_information.md)
 
-**To be confirmed**
 
-## Installation
-### For users
-[Front end GUI](https://github.com/orppst/pst-gui)
+There is also a [Front end CLI](https://github.com/orppst/pst-cli-app)  under development which will offer a way of manipulating proposals via scripting.
 
-[Front end CLI](https://github.com/orppst/pst-cli-app) - under development
-
-### For Developers 
-[Overarching project](https://github.com/orppst)
-
-[Back end API](https://github.com/orppst/pst-api-service)
-
-## Setup
-
-Go to the application URI (TBC) and register as a new user. 
-Then login with your new credentials where you will be asked to provide your organisation details by either selecting 
-from a list of existing institutions or supplying information about your organisation if not present in the list.
-
-## Get started
-
-Start by going to the **Creating Proposals** page. 
-
-_Please note that the screenshots in this guide were taken using an alpha version of Polaris so may contain 
-some stylistic and naming differences to the version you are using._
 
 

mkdocs.yml

@@ -36,6 +36,9 @@ theme:
 markdown_extensions:
   - tables
   - footnotes
+# TODO add this once https://github.com/mikitex70/plantuml-markdown/pull/94 has been done
+#  - plantuml_markdown:
+#      server: https://www.plantuml.com/plantuml  # PlantUML server, for remote rendering
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid