Zie beneden voor een TODO-lijstje met zaken die de site nog beter kunnen maken (patches welkom!).
Hoe de website bij te werken:
De broncode van de website is beschikbaar in git.
Zie beneden voor een TODO-lijstje met zaken die de site nog beter kunnen maken (patches welkom!).
Hoe de website bij te werken:
De broncode van de website is beschikbaar in git.
git clone https://codeberg.org/enosig/enosig-www.git
Je hebt nu een directory die enosig-www heet. Ga in die directory staan.
cd enosig-www
Voor het ophalen van de actuele versie doe je:
git switch main
git pull
git switch --create kras # maakt "branch" 'kras' aan
Bewerk de pagina die je wilt bewerken.
Controleer het resultaat.
Om je wijzigingen upstream zien te krijgen: informeer de mailinglijst.
Wat je alvast kunt / moet doen:
git diff # wijzigingen tonen
edit file
git diff # nog een keer wijzigingen tonen
git add files
git commit
# je bent in $EDITOR
# beschrijf wat je gewijzigd hebt
# bewaar ("save"), en sluit editor
# er volgt nog wat output
git format-patch main
# er worden "patches" aangemaakt
Dit kan op verschillende manieren. Overlap die ze hebben is dat er samenwerking met enosig is.
Zelf kiezen voor welke werkwijze je gaat. (open source is ook keuze hebben, ook keuze maken.)
Elke poging om een "patch" op de mailinglist te krijgen is goed.
Wil je als een echte linux kernel hacker doen, doe dan je voordeel met git send-email
Vertel op de mailinglist wat de URL van jouw git repository is. En in welke branch je wijzigingen zitten.
Deel twee bestaat dan uit:
Je hebt een reputatie opgebouwd en het privilege gekregen om `git push` te mogen doen.
Configureer een andere `push URL` voor de `fetch URL`.
git remote set-url --push origin ssh://git@codeberg.org/enosig/enosig-www.git
Controleer met `git remote -v` wat het resultaat met zijn.
origin https://codeberg.org/enosig/enosig-www.git (fetch) origin ssh://git@codeberg.org/enosig/enosig-www.git (push)
Het assymetrische, de heenweg anders als terugweg, heeft als voordeel dat `pull` kan gebeuren zonder SSH-keys actief te hebben. Ook is het een controle op werkt het HTTPS deel nog.
Stel jij bent kareltje en hebt een reputatie opgebouwd. Echter bezwaar om een account aan te maken op een centrale plaats. Want dat wringt met het decentrale dat `git` is.
Lever dan het publieke deel van SSH-key aan. Die key wordt toegevoegd aan de "sleutelring" van iemand anders.
Hoe werkbaar dat is, gaan we vanzelf zien. stappers meld zich als vrijwilliger om SSH-key van kareltje als eigen key te behandelen. (Upload naar centrale plaats, kareltje houdt private key bij zich)
Eigenlijk best vreemd: Je wilt samenwerken, maar je kiest er voor om iets tussen de samenwerkende partijen te zetten.
Je maakt een account aan op dezelfde website als waar de git repository staat.
merge request
(Hier verder geen toelichting wat een MR is.)
Maak via IRC of mailinglist kenbaar dat er wijzigingen zijn geweest.
Doe in afwachting van een reactie andere goede dingen. (Geef mensen tijd om te reageren op je bericht.)