added howto

This commit is contained in:
2026-04-20 18:49:44 +02:00
parent e612af4c69
commit c0d7fa51de

50
docs/howto.md Normal file
View File

@@ -0,0 +1,50 @@
# How to contribute - Wiki bearbeiten
## Wo?
Die Daten liegen im Git-Repository unter [git.mypapercloud.de/fierke/tagwiki](https://git.mypapercloud.de/fierke/tagwiki). Im Ordner `docs` liegen per Ordnerstruktur die einzelnen Inhalte (markdown).
## Warum über Git?
Git ist ein sehr nützliches Tool zu Versionierung von Inhalten - seine Funktionsweise zu beherrschen, schadet nie, denn es wird nicht nur in der Programmierung, sondern auch in anderen naturwissenschaftlichen Bereichen eingesetzt.
## Wie?
Stellen Sie hierfür sicher, dass [git](https://git-scm.com) auf Ihrem Rechner installiert und zu `PATH` hinzugefügt ist.
1. Repository klonen:
```sh
git clone https://git.mypapercloud.de/fierke/tagwiki.git
cd tagwiki
```
2. Fork im Webinterface erstellen
- Repository im Browser öffnen
- "Fork" auswählen
- Eigene Kopie unter Ihrem Benutzerkonto anlegen
3. Fork als Remote hinzufügen:
```sh id="r61g83"
git remote add fork https://git.mypapercloud.de/IHR-NUTZERNAME/tagwiki.git
```
4. Neue Branch für Änderungen erstellen:
```sh id="71qtdy"
git checkout -b meine-aenderungen
```
5. Dateien bearbeiten (siehe [Markdown](/markdown)-Dokumentation)
6. Änderungen übernehmen:
```sh id="oxtavh"
git add .
git commit -m "Beschreibung der Änderung"
```
7. Änderungen auf den Fork pushen:
```sh id="1n5m27"
git push fork meine-aenderungen
```
8. Pull Request erstellen:
- Fork im Webinterface öffnen
- Neue Branch auswählen
- "Pull Request" / "Merge Request" erstellen
- Ziel-Repository ist `fierke/tagwiki`