User documentation ready for discussion

[rkweehinzmann]

Dear all,

please take a look at the user documentation. In some cases there are still place holders, eg. in jobs or instruments. Any feedback is welcome, please put any questions you would like the user documentation to answer.

The structure is to ease interconnection with the operators guide. However, please focus only on the user part for now, thanks.

Cheers,
Regina

[LAShemilt]

This is a really great start to the user documentation and I think it should be merged pending the requested changes are done.

I have a few overarching comments to this review:

1. Audience. Whilst I like the style of this guide in places I think it is not clear who are audience is. Is this a help guide or technical documentation? It feels a bit like the two.
2. Pronouns. We should agree a strategy for pronouns in the documentation. If it is a help guide, I favour you throughout. If we want to make it more formal and refer to the user then we should use either “s/he” or “they” as the pronoun
3. Impact of messaging. This is the first entry point into SciCat we want the guide to be readable, accurate and clear, but we want people to use SciCat so we need to make sure that the guide demonstrates the advantages of this system.

I think we could look at the structure again on another MR. Addressing it here will make things quite comples.

[LAShemilt]

Thanks for the changes