closer to usable results

2026-06-05 14:01:46 +02:00
parent 31ec5bf46c
commit 85159ebc35
4 changed files with 79 additions and 57 deletions
@@ -1,54 +0,0 @@
-# Useful Links
-
-This is a collection of useful Links. The date in brackets show when the link was last
-veryfied to work.
-
-## caQtDM links
-
- [Main documentaion](https://caqtdm.github.io/documentation.html) (05.05.2026)
- [Beamline Guidelines](https://intranet.psi.ch/en/controls/caqtdm-guidelines-beamlines-sls-2-0) (05.05.2026)
- [Control Room Styleguide](https://acceleratorwiki.psi.ch/wiki/Application_Development_Style_Guide_for_the_PSI_Main_Control_Room) (05.05.2026)
-
-
-
-## Naming conventions
-
- [SLS 2.0 Naming Convention link list](https://indico.psi.ch/event/15589/) (5.5.2026)
- [SwissFEL](https://intranet.psi.ch/en/controls/swiss-feldevice-naming) (5.5.2026)
- [PROSCAN](https://intranet.psi.ch/de/controls/proscan-device-naming) (5.5.2026)
- [HIPA](https://intranet.psi.ch/de/controls/proton-accelerator-naming) (5.5.2026)
-
-
-## Facility Operation schedule
-
- [SLS](https://duo.psi.ch/duo/public_calendar.php) (5.5.2026)
- [HIPA and PROSCAN (pdf)](https://intranet.psi.ch/en/asa/betriebs-programme) (5.5.2026)
- [SwissFEL Overview](https://duo.psi.ch/duo/public_calendar.php?LAYOUT=&BEAMLINE=6&CBLIND=&POS=4052)  (5.5.2026)
- [Elog (SLS preselected, select other logbooks on the upper left side)](https://elog-gfa.psi.ch/SLS/?rsort=Wann) (5.5.2026)
-
-
-## SSH Links
-
- [Presentation slides "SSH Deep Dive" by Konrad Bucheli](https://rse.psi.ch/events/2026-05-05/Bucheli/) (6.5.2026)
- [OpenSSH home page](https://www.openssh.org/) (6.5.2026)
- [SSH cheat sheet](https://computingforgeeks.com/ssh-commands-cheat-sheet-linux/) (6.5.2026)
- [Wikibooks: OpenSSH](https://en.wikibooks.org/wiki/OpenSSH) (6.5.2026)
- [SSH academy](https://www.ssh.com/academy/ssh) (6.5.2026)
-
-
-## Driver Documentation links
-
- [Stream Device](https://paulscherrerinstitute.github.io/StreamDevice/) 
- [RegDev](https://github.com/paulscherrerinstitute/regdev) 
- [OPC-UA](https://gitea.psi.ch/epics_driver_modules/opcua)
-
-
-##  General
-
- [PSI Phoebook](https://intranet.psi.ch/de/suche/telefonbuch-und-e-mail) (5.5.2026)
- [Indico homepage of PSI](https://indico.psi.ch/)  (5.5.2026)
- [Hardware Database Inventory](https://inventory.psi.ch/) (5.5.2026)
- [EPICS Homepage](https://epics-controls.org/)  (5.5.2026)
- [PSP-Checker](https://psiexplorerhana.psi.ch/?nonav=true) (5.5.2026)
- [Accelerator Status (ext)](https://cas-status.psi.ch/) (6.5.2026)
- [Web caQtDM (int)](http://cas-novnc-srv-00/) (6.5.2026)
@@ -0,0 +1,14 @@
+# About the Section Controls
+
+The section "Control Systems" is part of the department "Elektronics and 
+Control Systems" (AEK) in the PSI Center for "Accelerator Science and 
+Engineerin" (CAS).
+
+**Center Leader:** [Prof. Dr. Mike Seidel](https://intranet.psi.ch/en/people/mike-seidel)
+
+**Department Head:** [Dr. Thomas Schilcher](https://intranet.psi.ch/en/people/thomas-schilcher)
+
+**Section Head:** [Dr. Tine Celcer](https://intranet.psi.ch/en/people/tine-celcer)
+
+**Administration Office:** [Maria Guarino Tucci](https://intranet.psi.ch/en/people/maria-guarino-tucci)
+ 
@@ -1,5 +1,53 @@
-# Home
+# Controls Documentation Home

-Some useful stuff about and for Controls
+This is a collection of useful Links. The date in brackets show when the 
+link was last veryfied to work.


+
+## Facility Operation schedule
+
+- [SLS](https://duo.psi.ch/duo/public_calendar.php) (5.5.2026)
+- [HIPA and PROSCAN (pdf)](https://intranet.psi.ch/en/asa/betriebs-programme) (5.5.2026)
+- [SwissFEL Overview](https://duo.psi.ch/duo/public_calendar.php?LAYOUT=&BEAMLINE=6&CBLIND=&POS=4052)  (5.5.2026)
+- [Elog (SLS preselected, select other logbooks on the upper left side)](https://elog-gfa.psi.ch/SLS/?rsort=Wann) (5.5.2026)
+
+## Naming conventions
+
+- [SLS 2.0 Naming Convention link list](https://indico.psi.ch/event/15589/) (5.5.2026)
+- [SwissFEL](https://intranet.psi.ch/en/controls/swiss-feldevice-naming) (5.5.2026)
+- [PROSCAN](https://intranet.psi.ch/de/controls/proscan-device-naming) (5.5.2026)
+- [HIPA](https://intranet.psi.ch/de/controls/proton-accelerator-naming) (5.5.2026)
+
+
+## SSH Links
+
+- [Presentation slides "SSH Deep Dive" by Konrad Bucheli](https://rse.psi.ch/events/2026-05-05/Bucheli/) (6.5.2026)
+- [OpenSSH home page](https://www.openssh.org/) (6.5.2026)
+- [SSH cheat sheet](https://computingforgeeks.com/ssh-commands-cheat-sheet-linux/) (6.5.2026)
+- [Wikibooks: OpenSSH](https://en.wikibooks.org/wiki/OpenSSH) (6.5.2026)
+- [SSH academy](https://www.ssh.com/academy/ssh) (6.5.2026)
+
+
+## Driver Documentation links
+
+- [Stream Device](https://paulscherrerinstitute.github.io/StreamDevice/) 
+- [RegDev](https://github.com/paulscherrerinstitute/regdev) 
+- [OPC-UA](https://gitea.psi.ch/epics_driver_modules/opcua)
+
+## caQtDM links
+
+- [Main documentaion](https://caqtdm.github.io/documentation.html) (05.05.2026)
+- [Beamline Guidelines](https://intranet.psi.ch/en/controls/caqtdm-guidelines-beamlines-sls-2-0) (05.05.2026)
+- [Control Room Styleguide](https://acceleratorwiki.psi.ch/wiki/Application_Development_Style_Guide_for_the_PSI_Main_Control_Room) (05.05.2026)
+
+
+##  General
+
+- [PSI Phoebook](https://intranet.psi.ch/de/suche/telefonbuch-und-e-mail) (5.5.2026)
+- [Indico homepage of PSI](https://indico.psi.ch/)  (5.5.2026)
+- [Hardware Database Inventory](https://inventory.psi.ch/) (5.5.2026)
+- [EPICS Homepage](https://epics-controls.org/)  (5.5.2026)
+- [PSP-Checker](https://psiexplorerhana.psi.ch/?nonav=true) (5.5.2026)
+- [Accelerator Status (ext)](https://cas-status.psi.ch/) (6.5.2026)
+- [Web caQtDM (int)](http://cas-novnc-srv-00/) (6.5.2026)
@@ -9,7 +9,7 @@ useful stuff as a kind of "quick link".

 ## What do we do?

-This question is ansered in the tab *"2.Services Portfolio"* with a list of 
+This question is ansered in the tab *"2. Services Portfolio"* with a list of 
 all services supported by the Controls section. In addition you can find here 
 lists of supported hardware and epics drivers.

@@ -22,3 +22,17 @@ Controls Contacts for various expert groups, beamlines, and topics as well as
 the service owners of Controls services. The *"5. Controls Internal"* tab 
 contains internal procedures like onboarding, how to do travel requests and
 the Control system team charter.  
+
+## How to change or contribute content
+
+This webpage is hosted in Gitea: 
+[](https://gitea.psi.ch/Controls/gitea-pages/actions)
+
+It uses the site generator [Zensical](https://zensical.org/docs/setup/basics/) 
+together with Gitea Actions to convert
+[Markdown](https://www.markdownguide.org/cheat-sheet/) text files 
+into html webpages. To contribute, check out the gitea repository, update
+the content and check in again 
+([a simple git help](https://rogerdudler.github.io/git-guide/index.html)).
+A predefined workflow will publish the changes automatically after some 
+seconds - just reload the webpage in your browser.