initial structure
This commit is contained in:
commit
ef6a1435ad
8 changed files with 697 additions and 0 deletions
59
README.md
Normal file
59
README.md
Normal file
|
|
@ -0,0 +1,59 @@
|
|||
# FriedenSau 2022
|
||||
|
||||
Repository der FriedenSau. Hier werden Artikel geschrieben und Materialien gesammelt.
|
||||
Alles ist versioniert und mit hilfreichen Projektmanagement-Werkzeugen verknüpft.
|
||||
|
||||
## Arbeitsablauf
|
||||
|
||||
### Idee und Recherche
|
||||
|
||||
Am Anfang steht die Idee für einen Artikel.
|
||||
Diese wird zunächst unter **Issues** eingetragen und vorgestellt (**Neues Issue**).
|
||||
Der Titel sollte dabei kurz und prägnant den Kern der Idee beschreiben (z.B. "Neue Redaktion").
|
||||
Dann sollte die Idee hinreichend beschrieben werden.
|
||||
Das Issue sollte über die Seitenleiste mit dem Laben "**Artikel-Idee**" als solche gekennzeichnet werden.
|
||||
Nach dem Erstellen kann sie so von dem ganzen Team gesehen werden.
|
||||
|
||||
### Artikel schreiben
|
||||
|
||||
In dem Issue können nun bereits konkrete Informationen und Ideen zur Ausgestaltung gesammelt werden.
|
||||
Vielversprechende Issues werden dann dem **Meilenstein** einer konkreten Ausgabe zugeordnet oder nur statt "Artikel-Idee" als "**Writing in Progress**" gekennzeichnet.
|
||||
Idealerweise wird auch gleich ein Mitarbeiter als **Zuständig** markiert.
|
||||
Dieser kann nun beginnen, den Artikel auszuformulieren.
|
||||
|
||||
Dazu sollte im Verzeichnis `artikel` eine **Neue Datei** angelegt werden.
|
||||
Um die Datei in einem eigenen Verzeichnis abzulegen, kann dessen Namen durch einen *Forward*-Slash (**`/`**) getrennt vor den Dateinamen geschrieben werden.
|
||||
Der Verzeichnisname sollte möglichst kurz, in Kleinbuchstaben und mit Bindestrichen statt Leerzeichen sein (z.B. `nasser-fleck`).
|
||||
Der Artikel, der letztendlich in der Ausgabe erscheinen wird, sollte immer **`README.md`** benannt werden.
|
||||
So wird der Inhalt sofort angezeigt, wenn man das Verzeichnis betritt, und es gibt im Satz keine Unsicherheit, was der eigentliche Artikel sein soll.
|
||||
In dem Verzeichnis können außerdem artikelspezifische Fotos hochgeladen oder beliebig in Hilfsdateien gearbeitet werden.
|
||||
|
||||
Währenddessen kann das Issue weiter für neue Informationen und zur Diskussion genutzt werden.
|
||||
Mitarbeiter können mit vorangestelltem `@` erwähnt werden und bekommen das als Benachrichtigung in der oberen rechten Ecke angezeigt, sobald sie das nächste Mal eine beliebige Seite der Plattform aufrufen.
|
||||
|
||||
Änderungen müssen eingecheckt werden ("committen").
|
||||
Um in der Versionsverwaltung den Überblick zu behalten, sollte die Bezeichnung den Inhalt der Änderung widerspiegeln.
|
||||
Zuerst sollte der bearbeitete Artikel erwähnt werden (Name des Verzeichnisses) und dann die Änderung.
|
||||
Das muss aber nicht zu detailliert geschehen, da es nur der groben Einordnung dient.\
|
||||
Beispiele:
|
||||
- nasser-fleck: Artikel angefangen
|
||||
- nasser-fleck: Artikel weitergeschrieben
|
||||
- nasser-fleck: Satzzeichen vergessen
|
||||
- nasser-fleck: Artikel weitergeschrieben
|
||||
- nasser-fleck: typos berichtigt
|
||||
- nasser-fleck: Endparagraph
|
||||
- nasser-fleck: Artikel umgeschrieben
|
||||
- ...
|
||||
|
||||
### Korrekturlesen und Satz
|
||||
|
||||
Ist der Artikel aus Sicht des Autors fertiggeschrieben, kann er korrekturgelesen werden.
|
||||
Das wird durch Hinzufügen des Labels "**Korrekturlesen**" zu dem zugehörigen Issue signalisiert.
|
||||
Nun können diesen Mitarbeiter finden, die gerade frei sind oder selbst vom Schreiben eine Pause machen, und Fehler anmerken.
|
||||
Werden keine Fehler gefunden, wird dies ebenfalls als Nachricht im Issue vermerkt.
|
||||
Dabei muss jeweils der **Permalink** der Datei mit angegeben werden, um die genaue korrekturgelesene Version zu referenzieren.
|
||||
|
||||
Haben zwei Mitarbeiter den Artikel in der aktuellen Fassung korrekturgelesen, ohne Fehler festzustellen, kann das Label "Korrekturlesen" entfernt und das Issue als "**Druckfertig**" markiert werden.
|
||||
|
||||
Druckfertige Artikel werden schließlich in die Ausgabe eingearbeitet und die zugehörigen Issues geschlossen.
|
||||
Fertige Ausgaben werden in `/ausgaben` versioniert.
|
||||
Reference in a new issue