Zurück zu ISG IT Dienstleistungen

Kurzbeschreibung

Das Wiki wird unter wiki.vseth.ethz.ch von vielen Aktiven im VSETH regelmässig für Dokumentation und Wissenserhalt verwendet. Ein gut geführtes Wiki kann vorallem für neue Vorstandsmitglieder die Vereinsarbeit enorm erleichtern. Alle Fachvereine, Kommissionen und andere dem VSETH angehörigen Organisationen können den Wiki Service kostenlos nutzen.

Seitenübersicht

Dokumentation für NutzerInnen

Allgemeines

Der Wiki Service wird von der VSETH ISG verwaltet und stellt den Nutzergruppen einen eigenen Bereich zur Verfügung. Diesen eigenen Bereich wiederum wird von den Fachvereinen und Co. selbst verwaltet und überarbeitet.

Beispiel

Der Fachverein XY möchte gerne sein Wissen und seine Erfahrungen festhalten, um die Vereinsarbeit den zukünftigen Verantwortichen einfacher zu machen. Der Fachverein entscheidet sich zu diesem Zweck, das Wiki des VSETH zu gebrauchen. Sie legen fest: Nur die IT-Verantwortliche Person und der Präsident / die Präsidentin dürfen das Doku-Wiki bearbeiten. Einsicht hat der gesamte Vorstand. Möchte jetzt zum Beispiel die für Events verantwortliche Person etwas im Wiki bearbeiten, macht sie dies über die IT-Verantwortliche Person oder über ihren Präsidenten / ihre Präsidentin. Wichtige Informationen wie "wie organisiert man erfolgreich eine Generalversammlung" sind nun im Doku-Wiki festgehalten und können vorallem bei Fluktuationen, d.h. Ein- und Austritte im Vorstand, weiterhelfen. Bei einem Wechsel der IT-Verantwortlichen Person oder des Präsidenten / der Präsidentin, erhält die neue Person in der entsprechenden Funktion die Berechtigungen im Wiki.

Zugriff

Der Zugriff auf das Wiki erfolgt in der Regel über die Gruppen des VSETH Gruppenkonzept. Alle Gruppen des VSETH werden ins Wiki synchronisiert und werden verwendet, um die Berechtigungen zu verwalten.

Zum Beispiel: Der VIS hat ein Wiki um Informationen für seine Mitglieder bereitzustellen. Der Zugriff auf das Wiki wird nach Anfrage des OIVs von der ISG an die Gruppe vseth-1116-vis geknüpft. Das heisst alle User in dieser Gruppe erhalten Zugriff auf das Wiki.

Es ist ausserdem möglich, das Wiki für anonyme User öffentlich zu machen. Das bedeutet, dass das nethz Login nicht mehr benötigt wird, um das Wiki zu sehen. In diesem Fall erhält der anonyme User lediglich eine Lese-Berechtigung und kann Inhalte weder bearbeiten, noch kommentieren.

Berechtigungslevel

Im Wiki gibt es verschiedene Berechtigungslevel, die auf Gruppen vergeben werden können.

	Lesen	Kommentieren	Bearbeiten	Inhalte hinzufügen	Inhalte löschen	Vorlagen erstellen
spaceAdmin
contentManager
contributor
commenter

Die spaceAdmin Berechtigung wird ausschliesslich an OIVs vergeben.

Seiten Einschränkungen

Im Wiki können Seiten auch einzeln eingeschränkt werden. Eine Unterscheidung wird hier nur zwischen Lese- und Bearbeitungsrechten gemacht. Diese Einschränkungen sind immer restriktiver als Berechtigungen auf dem gesamten Wiki. Das heisst, ist eine Gruppe berechtigt ein Wiki zu Lesen, jedoch nicht zu bearbeiten, so kann diese Gruppe keine Unterseiten des Wiki bearbeiten - unabhängig davon, ob eine spezielle Bearbeitungsberechtigung auf eine spezifische Seite vergeben wurde oder nicht!

Beispiel:

Der VIS hat ein Wiki für seine Kommissionsmitglieder. Da dieses Wiki vom Vorstand unterhalten wird, hat die Gruppe vseth-1116-vis-vs Bearbeitungsrechte auf dem Wiki und die Gruppe vseth-1116-vis-kom hat lediglich Leserechte. Der Vorstand erstellt nun Unterseiten wo sich die verschiedenen Kommissionen jeweils vorstellen können und erteilt den Kommissionen auf der jeweiligen Seite Bearbeitungsrechte. Trotzdem kann Kommissionsmitglied Max Mustermann seine Kommissionsseite nicht bearbeiten, da seine Gruppe (oder eine Parent Gruppe) auf dem gesamten Wiki keine Bearbeitungsrechte hat. Um das Problem zu lösen müssen erst der ganzen Gruppe vseth-1116-vis-kom auf dem Wiki Bearbeitungsrechte erteilt werden. Danach können die einzelnen Seiten Berechtigungen nach Kommission erteilt werden sodass zum Beispiel auf der CAT Unterseite lediglich die Gruppe vseth-1116-vis-kom-cat Bearbeitungsrechte erhält, die Gruppe vseth-1116-vis-kom nur Leserechte.

Analytics

Hier findest du die Analyse-Daten vom Wiki.

Plugins

Das Wiki ist nicht nur ein Ort, um Notizen aufzuschreiben. Sinnvolle Makros und Plugins machen das Wiki zu vielem mehr als nur das! Wir können euch folgende Plugins anbieten und empfehlen sehr, diese zu nutzen:

Pluginname	Verwendung	Kommentar
Scroll View	Wiki-Inhalt als Webseite darstellen	Sinnvoll, wenn gewisse Seiten oder Informationen veröffentlicht werden möchten. Unsere User-Dokumentation docs.vseth.ethz.ch wird mit diesem Plugin veröffentlicht.
Scroll Translation	Wiki mehrsprachig führen	Ob für Austauschstudierende oder sonstige fremdsprachige Studenten lohnt es sich, das Wiki mehrsprachig zu führen.
Google Drive Integration	Google Drive Dateien und Google Drive Ordner direkt oder via Link ins Wiki einbetten	Da der VSETH den GSuite Service anbietet und dieser oft und von vielen Usern gebraucht wird, ist dieses Plugin sehr sinnvoll.
Draw Io Integration	Onlineapplikation zum Erstellen von Diagrammen, Tabellen und nützlichen Übersichten	Weitere Informationen hier. Kann direkt im Wiki verwendet werden!
Secure	Zum schützen von sensitiven Informationen im Wiki wie z.B. Passwörter	Zugriffe können für bestimmte Benutzer oder Gruppen aktiviert oder deaktiviert werden.
Markdown Rendering

FAQ

Hier findest du die wichtigsten Antworten auf häufig gestellte Fragen. Falls deine Frage hier nicht beantwortet wird, bitte schreibe eine E-Mail an vseth-it-support@ethz.ch.

Wer kann das Wiki des VSETH benutzen?

Grundsätzlich steht der Wiki Service allen dem VSETH angehörigen Gruppierungen zu. Dazu gehören alle Fachvereine, Kommissionen und andere studentische Organisationen.

Wer hat die Berechtigungen zum Bearbeiten des Doku-Wikis?

Die Nutzergruppen selbst bestimmen, wer die Berechtigung zum Bearbeiten des Doku-Wikis hat und wer nicht.

Wer kann das Doku-Wiki einsehen?

Die Nutzergruppen selbst bestimmen, wer die Berechtigung zum Einsehen des Doku-Wikis hat und wer nicht.

Wie kann ich die Berechtigungen ändern?

Dazu schreibst du direkt an vseth-it-support@ethz.ch

Es gab Wechsel innerhalb des Vorstands. Wie funktioniert das mit den Berechtigungen?

Berechtigungen werden in der VSETH IT an Gruppen oder Funktionen geknüpft. Zum Beispiel ist der Vorstand einer Kommission eine Gruppe, oder die IT-Verantwortliche Person eine Funktion. Das hat den Vorteil, dass die Berechtigungen unabhängig von der aktuellen Zusammensetzung der Gruppe oder der aktuellen Person in einer Funktion ist. Bei Fluktuationen gehen die Berechtigungen automatisch auf die neuen Personen über.

Auf welchem Service basiert das Wiki?

Unser Service basiert auf Confluence. Confluence ist eine kommerzielle Wiki-Software, die haupstächlich für die Dokumentation und Kommunikation von Wissen und den Wissensaustausch in Unternehmen und Organisationen verwendet wird.

Wie logge ich mich ein?

Das Login funktioniert über Switch. Also per Nethz Account.

Die Mails die ich zum Wiki auf meinen ETH Student Account bekomme nerven mich. Kann ich das abstellen?

Du kannst die Mails nicht auf Confluence abbestellen. Allerdings kannst du in deinem Student Account eine Posteingangsregel erstellen, die alle GSuite Mails umleitet oder einfach löscht. Ein HowTo dazu findest du hier.

Wie kann ich meine Wiki-Seite bearbeiten?

Dazu findest du genügend Informationen im Internet. Zum Beispiel hier.

Wie kann ich eine Seitenvorlage erstellen?

Dies kann nur euer OIV als spaceAdmin tun und zwar unten links unter Space Tools > Content Tools > Templates > Create New Template. Mehr Infos dazu findest du hier.

Ich habe noch immer eine Frage

Bitte melde dich bei einer Frage direkt an vseth-it-support@ethz.ch

Dokumentation für OIV

Hinweis

Dieser Abschnitt ist nur für Organisations-Informatik-Verantwortliche (OIVs) relevant.

Kundennutzen

Der Wiki Service bietet den Nutzergruppen einen eigenen Bereich für Dokumentation und Wissenserhalt, welcher von der VSETH ISG verwaltet wird.

Kundengruppen und Preisstruktur

Der Wiki Service steht allen VSETH Organen, Fachvereinen und Assoziierten Organisationen zur Verfügung. Die Benutzung ist kostenlos.

Abhängigkeiten

Zur Nutzung des Wiki Service ist ein SWITCH - Login notwendig.

Konfiguration und Bestellung

Via Mail an vseth-it-support@ethz.ch.

Als OIV wirst du zum spaceAdmin des neuen Wikis. Ändere trotzdem bitte nicht die Space Permission Einstellungen! Mit der spaceAdmin Berechtigung kannst du Seitenvorlagen für deine Organisation erstellen.

Support

Grundlage für den Support-Prozess ist der allgemeine Support-Prozess des VSETH gemäss der User Dokumentation: Support. D.h. insbesondere, dass alle Support-Anfragen über das Ticketing System OTRs verwaltet werden. Fragen und Probleme können jederzeit an vseth-it-support@ethz.ch gemeldet werden. Die Informatik-Support-Gruppe des VSETH kümmert sich dann gemäss ihren Reaktionszeiten für Anfragen (SLAs) darum.