first stab at mkdocs migration

refactor CSCS and Meg content

add merlin6 quick start

update merlin6 nomachine docs

give the userdoc its own color scheme

we use the Materials default one

refactored slurm general docs merlin6

add merlin6 JB docs

add software support m6 docs

add all files to nav

vibed changes #1

add missing pages

further vibing #2

vibe #3

further fixes

docs/merlin6/99-support/troubleshooting.md

@@ -0,0 +1,48 @@
+---
+title: Troubleshooting
+#tags:
+keywords: troubleshooting, problems, faq, known problems
+last_updated: 07 September 2022
+#summary: ""
+sidebar: merlin6_sidebar
+permalink: /merlin6/troubleshooting.html
+---
+
+For troubleshooting, please contact us through the official channels. See [Contact](contact.md) 
+for more information. 
+
+## Known Problems
+
+Before contacting us for support, please check the **[Merlin6 Support: Known Problems](known-problems.md)** page to see if there is an existing
+workaround for your specific problem.
+
+## Troubleshooting Slurm Jobs
+
+If you want to report a problem or request for help when running jobs, please **always provide**
+the following information:
+
+1. Provide your batch script or, alternatively, the path to your batch script.
+2. Add **always** the following commands to your batch script
+
+   ```bash
+   echo "User information:"; who am i
+   echo "Running hostname:"; hostname
+   echo "Current location:"; pwd
+   echo "User environment:"; env
+   echo "List of PModules:"; module list
+   ``` 
+
+3. Whenever possible, provide the Slurm JobID.
+
+Providing this information is **extremely important** in order to ease debugging, otherwise
+only with the description of the issue or just the error message is completely insufficient
+in most cases.
+
+## Troubleshooting SSH
+
+Use the ssh command with the "-vvv" option and copy and paste (no screenshots please)
+the output to your request in Service-Now.  Example
+
+```bash
+ssh -Y -vvv $username@merlin-l-01.psi.ch
+```