cbwww/site/git.de.md

---
title: Code review
x-toc-enable: true
...

**NOTE TO GNU Boot AUDITORS: Obviously, these repository links are unofficial
and you'll want to change them to your own ones for GNUBoot.**

**The repositories below are real, containing the actual code for this
nonGeNUine Boot website intended for use by GNU Boot, images and also the [nonGeNUine
Boot 20230717 release](news/nongenuineboot20230717.md). The GNU project is both free,
and encouraged, to re-use this work officially.**

nonGeNUine Boot Repositories
===================

Informationen darüber wer an nonGeNUine Boot arbeitet und wer das Projekt betreibt
sind unter [who.md](who.md) zu finden.

Das nonGeNUine Boot Projekt hat hauptsächlich 3 Git Repositories:

* Build system: <https://codeberg.org/vimuser/gbmk>
* Webseite (+Anleitungen): <https://codeberg.org/vimuser/gbwww>
* Bilder (für die Webseite): <https://codeberg.org/vimuser/gbwww-img>

Weiter unten auf dieser Seite sind Mirror von `gbmk` und `gbwww` aufgelistet, 
sofern die Haupt Git Repositories nicht erreichbar sein sollten.

Zudem gibt es noch diese vom nonGeNUine Boot Projekt gehosteten Programme, welche
von nonGeNUine Boot entweder empfohlen oder verwendet werden:  

bucts is also there: <https://notabug.org/libreboot/bucts>

Du kannst diese Repositories herunterladen, sie nach deinen Wünschen ändern,
und dann deine Änderungen zur Verfügung stellen mithilfe der folgenden
Anleitungen.

Es wird empfohlen den nonGeNUine Boot build (alle zugehörigen Teile) in einer
GNU+Linux Umgebung herzustellen. Unter BSD Systemen ist das build system (gbmk)
beispielsweise nicht getestet.
Installiere `git` auf deinem GNU+Linux System und lade eines der Repositories
herunter.

Die Entwicklung von nonGeNUine Boot findet mithilfe der Versionskontrolle von
Git statt. Sieh in der [offiziellen Git Dokumentation](https://git-scm.com/doc)
nach, sofern Du nicht weisst wie man Git verwendet. 

Das `bucts` Repository wird auch vom nonGeNUine Boot Projekt gehostet, da das
Original Repository auf `stuge.se` nicht mehr verfügbar ist, seit wie dies
zuletzt geprüft haben. Das `bucts` Programm wurde von Peter Stuge geschrieben.
Du benötigst `bucts` sofern Du ein nonGeNUine Boot ROM intern auf ein Thinkpad X60 
oder T60 flashen möchtest, welches (derzeit) noch ein nicht-freies Lenovo 
BIOS verwendet. Anleitungen hierfür findest Du hier:\
[nonGeNUine Boot Installations Anleitungen](docs/install/)

Das `ich9utils` Repository wird erheblich vom `gbmk` build system verwendet.
Du kannst `ich9utils` allerdings auch separat herunterladen und verwenden.
Es erzeugt ICH9M descriptor+GbE Images für GM45 ThinkPads welche die ICH9M 
Southbridge verwenden. Es könnte auch für andere Systeme funktionieren,
welche dieselbe Platform bzw. denselben Chipsatz verwenden.
Dokumentation für `ich9utils` ist hier verfügbar:\
[ich9utils Dokumentation](docs/install/ich9utils.md)

gbmk (non**G**eNUine**B**oot**M**a**K**e)
---------------------

Dies ist das zentrale build system in nonGeNUine Boot. Man könnte auch sagen `gbmk` *ist*
nonGeNUine Boot! Das Git repository herunterladen:

	git clone https://codeberg.org/vimuser/gbmk
  
Der oben dargestellte `git` Befehl, wird das nonGeNUine Boot build system `gbmk`
herunterladen.
Du kannst dann folgendermassen in das Verzeichnis wechseln:

	cd gbmk

Ändere dies nach deinen Vorstellungen oder erstelle einfach einen build. 
Für Anleitungen bzgl. `gbmk` build, siehe [build Anleitungen](docs/build/).

Informationen über das build system selbst und wie es funktioniert, sind
verfügbar unter dem [gbmk maintenance guide](docs/maintain/).

gbwww and gbwww-img
-------------------

Die *gesamte* nonGeNUine Boot Website sowie Dokumentation befindet sich in einem
Git Repository.
Du kannst es folgendermassen herunterladen:

	git clone https://codeberg.org/vimuser/gbwww

Bilder befinden sich unter <https://avgnu.vimuser.org/> und sind verfügbar
in einem separaten Git Repository:

	git clone https://codeberg.org/vimuser/gbwww-img

Du kannst alles nach deinen Vorstellungen ändern. Beachte die nachfolgenden
Informationen wie Du deine Änderungen zur Verfügung stellen kannst.

Die gesamte Website ist in Markdown geschrieben, insbesondere die Pandoc Version. 
Die statischen HTML Seiten werden mit [Untitled](https://untitled.vimuser.org/)
generiert. Leah Rowe, die Gründerin von nonGeNUine Boot, ist auch die Gründerin des Untitled static
site generator Projekts.

Wenn Du möchtest, kannst Du einen lokalen HTTP Server einrichten und eine
lokale Version der Website herstellen. Bitte bedenke, dass alle Bilder nach
wie vor mit den Bildern auf <https://avgnu.vimuser.org/> verknüpft werden,
daher werden jegliche Bilder die Du `gbwww-img` hinzugefügt hast nicht auf
deiner lokalen `gbwww` Seite dargestellt, sofern Du die Bilder (die Du
hinzugefügt hast) mit `avgnu.vimuser.org` verknüpfst. Es ist jedoch erforderlich, 
dass sich diese Bilder auf avgnu.vimuser.org befinden.

Sofern Du der Webseite Bilder hinzufügen möchtest, füge diese ebenso
dem `gbwww-img` Repository hinzu, indem Du diese dann jeweils mit diesem Link verknüpfst
<https://avgnu.vimuser.org/path/to/your/new/image/in/gbwww-img>.
Wenn dein Patch der nonGeNUine Boot Webseite hinzugefügt wird, werden erscheinen deine Bilder live.

Zu Entwicklungszwecken, könntest Du deine Bilder auch lokal verknüpfen, und
anschliesend die URLs anpassen sobald Du deine Patches für die Dokumentation/Webseite schickst.

Eine Anleitung wie Du eine lokale Version der Webseite herstellen kannst,
befinden sich auf der Untitled Webseite. Lade untitled
herunter, und erstelle in dem `untitled` Verzeichnis ein Verzeichnis mit
dem Namen `www/` dann wechsle in dieses Verzeichnis und klone das `gbwww`
Repository dorthin. Konfiguriere deinen lokalen HTTP Server entsprechend.

Nochmal, Anleitungen hierfür findest Du auf der Untitled Webseite.

Name nicht erforderlich
-----------------

Beiträge die Du hinzufügst, werden in einem für jeden zugänglichen Git
Repository öffentlich aufgezeichnet. Dies betrifft ebenso den Namen sowie
die email Adresse des Mitwirkenden.

Du musst bei Git keinen Autoren Namen bzw. keine email Addresse verwenden,
mithilfe derer Du identifizierbar bist. Du kannst `nongenuineboot Contributor`
verwenden und deine email Addresse könnte als john@doe.com
spezifiert werden. Es ist Dir gestattet dies zu tun, sofern Du deine Privatsphäre
wahren möchtest. Wir glauben an Privatsphäre. Sofern Du anonym bleiben möchtest 
werden wir dies respektieren.

Natürlich kannst Du jeglichen Namen und/oder jegliche email Adresse verwenden
die Du möchtest.

Rechtlich gesprochen, jegliches Urheberrecht fällt automatisch unter die
Berner Übereinkunft zum Schutz von Werken der Literatur und Kunst. Es spielt
keine Rolle welchen Namen, oder ob Du tatsächlich überhaupt ein Urheberrecht
deklariert hast (aber wir setzen voraus das bestimmte Lizenzen für das
Urheberrecht verwndet werden - lies mehr darüber auf dieser Seite).

Sofern Du einen anderen Namen sowie eine andere email Adresse für deine 
Commits/Patches verwendest dann solltest Du anonym sein. Verwende 
[git log](https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History)
und [git show](https://git-scm.com/docs/git-show) um dies zu überprüfen
bevor Du einem öffentlichen Git Repository Änderungen hinzufügst.

Lizenzen (für Mitwirkende)
--------

Make sure to freely license your work, under a free license.

*Always* declare a license on your work! Not declaring a license means that
the default, restrictive copyright laws apply, which would make your work
proprietary, subject to all of the same restrictions.

The Free Software Foundation maintains a handy dandy list, which you can review
here:

<https://www.gnu.org/licenses/license-list.en.html>