Wiki



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.


LesenKommentierenBearbeitenInhalte hinzufügenInhalte löschenVorlagen erstellen
spaceAdmin(tick)(tick)(tick)(tick)(tick)(tick)

contentManager

(tick)(tick)(tick)(tick)(tick)
contributor(tick)(tick)(tick)(tick)

commenter(tick)(tick)



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 darstellenSinnvoll, wenn gewisse Seiten oder Informationen veröffentlicht werden möchten. Unsere User-Dokumentation docs.vseth.ethz.ch wird mit diesem Plugin veröffentlicht.
Scroll TranslationWiki mehrsprachig führenOb für Austauschstudierende oder sonstige fremdsprachige Studenten lohnt es sich, das Wiki mehrsprachig zu führen.
Google Drive IntegrationGoogle Drive Dateien und Google Drive Ordner direkt oder via Link ins Wiki einbettenDa 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 ÜbersichtenWeitere Informationen hier. Kann direkt im Wiki verwendet werden!
SecureZum schützen von sensitiven Informationen im Wiki wie z.B. PasswörterZugriffe 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


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

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

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

Als OIV der Organisation kannst du im Gruppenmanager deine Resourcen "Confluence Space" bearbeiten und die Berechtigungen anpassen. Anpassungen werden alle viertel Stunde syncronisiert.

Bei Unklarheiten kannst du auch an vseth-it-support@ethz.ch schreiben

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.

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.

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

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.

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

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

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.