Autorenportal: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
KKeine Bearbeitungszusammenfassung
 
(16 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
== Erste Schritte ==
== Erste Schritte ==


Um mitmachen zu können, musst du dir als erstes ein Benutzerkonto im Hostsharing-Wiki anlegen. Das Wiki verwendet den Single-Sign-On-Dienst von Hostsharing, sodass du das Wiki mit jedem gültigen Benutzerkonto nutzen kannst, das auf den Hostsharing-Servern angelegt ist. Du kannst dir natürlich für die Nutzung des Wikis einen eigenes Konto anlegen, zum Beispiel xyz00-wiki oder xyz00-hsdoku.
'''Anmelden'''


Nachdem du dich im Wiki angemeldet hast, ist es sinnvoll, wenn du zunächst die Benutzereinstellungen anpasst. Mindestens deine E-Mail-Adresse solltest du eintragen, denn dann kannst du Seiten im Wiki beobachten und Nachrichten bekommen, wenn eine von dir beobachtete Seite geändert wurde.
Das Wiki verwendet den Single-Sign-On-Dienst von Hostsharing, sodass Du Dich im Wiki mit jedem gültigen [[User]] (Benutzernamen) eines Servers von Hostsharing anmelden kannst. Du kannst Dir natürlich für die Nutzung des Wikis einen eigenen [[User]] in einem Deiner Pakete anlegen, zum Beispiel xyz00-wiki oder xyz00-hsdoku.


Du solltest dich außerdem auf der Hostsharing-Mailingliste [https://lists.hostsharing.net/mailman/listinfo/website/ website@] anmelden. Dort diskutieren wir über die Weiterentwicklung der Dokumentation.
'''Benutzereinstellungen'''
 
Nachdem du dich im Wiki angemeldet hast, ist es sinnvoll, wenn du zunächst deine Benutzereinstellungen anpasst (der Link [[Spezial:Einstellungen | Einstellungen]] - nur sichtbar, wenn Du angemeldet bist). Mindestens deine E-Mail-Adresse solltest du eintragen, denn dann kannst du Seiten im Wiki beobachten und Nachrichten bekommen, wenn eine von dir beobachtete Seite geändert wurde.
 
Du solltest dich außerdem auf der Hostsharing-Mailingliste (nicht öffentliche Liste) [https://lists.hostsharing.net/mailman/listinfo/website/ website@hostsharing.net] anmelden. Dort diskutieren wir über die Weiterentwicklung der Dokumentation.


== Wo ist Arbeit nötig? ==
== Wo ist Arbeit nötig? ==


Im Moment ist fast die gesamte Dokumentation verbesserungsbedürftig, sodass du dich eigentlich überall sinnvoll einbringen kannst. Ganz konkret kannst du zum Beispiel schauen, welche Seiten hier im Wiki als [[:Kategorie:Baustelle|Baustelle]] gekennzeichnet sind und diese überarbeiten. Wenn du ganz neue Dokumentation schreiben möchtest, solltest einen Blick auf die [[Vorstand:Notizen|Hinweise zur Einführung von HSAdmin]] werfen, damit du nicht einen Text schreibst, der schon in wenigen Wochen wieder veraltet ist.
<div style="margin-left:2em;font-style:italic">Die wichtigsten Links: [[:Kategorie:Baustelle|Baustelle]]n, [[Hostsharing_Wiki:Wunschliste Installationsanleitungen|Wunschliste Installationsanleitungen]], [[Ideen für das Wiki]], [[Fehler im Wiki]]</div>
 
Ganz konkret kannst du zum Beispiel schauen, welche Seiten hier im Wiki als [[:Kategorie:Baustelle|Baustelle]] gekennzeichnet sind und diese überarbeiten. Oder du erstellst eine ganz neue Dokumentation zu einem Thema.


Natürlich kannst du auch als Benutzer die Dokumentation lesen und darauf hinweisen, wo aus deiner Sicht Verbesserungen notwendig sind. Um eine Seite als Baustelle zu kennzeichnen, trage einfach folgendes ganz am Anfang der Seite ein:
Natürlich kannst du auch als Benutzer die Dokumentation lesen und in der Diskussion der entsprechenden Seite darauf hinweisen, wo aus deiner Sicht Verbesserungen notwendig sind. Um eine Seite als Baustelle zu kennzeichnen, trage einfach folgendes ganz am Anfang der Seite ein:


  <nowiki>{{Baustelle}}</nowiki>
<syntaxhighlight lang=twig>{{Baustelle}}</syntaxhighlight>


Am Anfang der Seite erscheint dann ein entsprechender Hinweis und die Seite wird in die [[:Kategorie:Baustelle|Liste der Baustellen]] aufgenommen.
Am Anfang der Seite erscheint dann ein entsprechender Hinweis und die Seite wird in die [[:Kategorie:Baustelle|Liste der Baustellen]] aufgenommen.
Zeile 29: Zeile 35:
* [[Hilfe:Textgestaltung|Textformatierung im Wiki]]
* [[Hilfe:Textgestaltung|Textformatierung im Wiki]]
* [[Hilfe:Link|Links anlegen]]
* [[Hilfe:Link|Links anlegen]]
== Für den Leser schreiben! ==
Entgegen der langjährigen Tradition in Akademie und Technik, schreiben wir hier vor allem für diejenigen Leser*innen, die noch nicht das wissen, was wir als Autoren wissen. Deshalb immer beim Schreiben von Dokumentation daran denken, daß der Leser womöglich zum allerersten Mal eine Einrichtung vornehmen will, die uns quasi selbstverständlich ist. Das bedeutet, daß die Anleitungen in diesem Wiki mit '''genauer Terminologie''' und ohne allzuviele Abkürzungen '''ausführlich''' sagen sollen, was der Leser machen muß.
*Falsch: "Dann über die Shell die entsprechenden Rewrite-Zeilen in die .htaccess einfügen."
*Besser: "Dann mit ssh als Paketuser xyz00-username an example.com anmelden und folgende Zeilen in die Datei ~/doms/example.com/htdocs-ssl/.htaccess einfügen: ..."
----
[[Kategorie:Hilfe]]
[[Kategorie:Hostsharing Wiki]]

Aktuelle Version vom 10. Juli 2024, 12:41 Uhr

Das Hostsharing-Wiki ist ein gemeinsames Projekt der Hostsharing-Mitglieder, in dem wir die Dokumentation der Dienste von Hostsharing überarbeiten und auf den aktuellen Stand bringen möchten. Auf dieser Seite findest du Informationen dazu, wie du dich daran beteiligen kannst.

Erste Schritte

Anmelden

Das Wiki verwendet den Single-Sign-On-Dienst von Hostsharing, sodass Du Dich im Wiki mit jedem gültigen User (Benutzernamen) eines Servers von Hostsharing anmelden kannst. Du kannst Dir natürlich für die Nutzung des Wikis einen eigenen User in einem Deiner Pakete anlegen, zum Beispiel xyz00-wiki oder xyz00-hsdoku.

Benutzereinstellungen

Nachdem du dich im Wiki angemeldet hast, ist es sinnvoll, wenn du zunächst deine Benutzereinstellungen anpasst (der Link Einstellungen - nur sichtbar, wenn Du angemeldet bist). Mindestens deine E-Mail-Adresse solltest du eintragen, denn dann kannst du Seiten im Wiki beobachten und Nachrichten bekommen, wenn eine von dir beobachtete Seite geändert wurde.

Du solltest dich außerdem auf der Hostsharing-Mailingliste (nicht öffentliche Liste) website@hostsharing.net anmelden. Dort diskutieren wir über die Weiterentwicklung der Dokumentation.

Wo ist Arbeit nötig?

Ganz konkret kannst du zum Beispiel schauen, welche Seiten hier im Wiki als Baustelle gekennzeichnet sind und diese überarbeiten. Oder du erstellst eine ganz neue Dokumentation zu einem Thema.

Natürlich kannst du auch als Benutzer die Dokumentation lesen und in der Diskussion der entsprechenden Seite darauf hinweisen, wo aus deiner Sicht Verbesserungen notwendig sind. Um eine Seite als Baustelle zu kennzeichnen, trage einfach folgendes ganz am Anfang der Seite ein:

{{Baustelle}}

Am Anfang der Seite erscheint dann ein entsprechender Hinweis und die Seite wird in die Liste der Baustellen aufgenommen.

Konventionen

Wenn du an der Dokumentation arbeitest, solltest du unsere Konventionen und Hinweise zu gutem Stil beachten.

Umgang mit der Wiki-Software

Wir verwenden als Software MediaWiki. Nachfolgend einige Links auf Hinweise dazu, wie du im Wiki Texte formatierst und Links anlegst. Gefahrlos ausprobieren kannst du die Wiki-Funktionen auf der Seite Sandkasten, diese ist explizit zum Experimentieren gedacht.

Für den Leser schreiben!

Entgegen der langjährigen Tradition in Akademie und Technik, schreiben wir hier vor allem für diejenigen Leser*innen, die noch nicht das wissen, was wir als Autoren wissen. Deshalb immer beim Schreiben von Dokumentation daran denken, daß der Leser womöglich zum allerersten Mal eine Einrichtung vornehmen will, die uns quasi selbstverständlich ist. Das bedeutet, daß die Anleitungen in diesem Wiki mit genauer Terminologie und ohne allzuviele Abkürzungen ausführlich sagen sollen, was der Leser machen muß.

  • Falsch: "Dann über die Shell die entsprechenden Rewrite-Zeilen in die .htaccess einfügen."
  • Besser: "Dann mit ssh als Paketuser xyz00-username an example.com anmelden und folgende Zeilen in die Datei ~/doms/example.com/htdocs-ssl/.htaccess einfügen: ..."