doc/wiz/gerrit-faq

1) Wo finde ich die Weboberflaeche?
   https://mg.mud.de/gerrit/

2) Wo ist die Anleitung?
   https://mg.mud.de/gerrit/Documentation/index.html

3) Wo ist die Anleitung fuer Projekteigentuemer?
   https://mg.mud.de/gerrit/Documentation/intro-project-owner.html

4) Wie clone ich ein Projekt / Repository
   git clone ssh://zesstra@mg.mud.de:29418/d/anfaenger/...
   mit SSH-Hostalias mgg:
   git clone ssh://mgg/d/anfaenger/...
   Auf der Weboberflaeche werden auch direkte Copy&Paste-Kommandos angezeigt.

5) Wie bekomme ich Aenderungen in gerrit?
   a) ohne Review
     Das geht, falls ihr Schreibrechte fuer direkten Push in den Branch
     habt:
     git push origin <local_branch>:<remote_branch>
     git push origin master:master
   b) mit Review
     Wenn ihr keine direkten Schreibrechte auf den Branch habt oder wollt,
     dass eure Aenderung von jemand anderem gelesen wird:
     git push origin <local_branch>:refs/for/<remote_branch>
     git push origin master:refs/for/master

   Nur der Zweig 'master' wird zwischen gerrit und dem Mud synchronisiert, alle
   anderen Zweige bleiben nur in gerrit.
   Eine ausfuehrlichere Darstellung gibt es in der Doku von gerrit:
   https://mg.mud.de/gerrit/Documentation/intro-user.html#upload-change
   Und noch ausfuehrlicher:
   https://mg.mud.de/gerrit/Documentation/user-upload.html

6) Welche Bedeutung haben die Review-Labels?
   Wenn ihr Aenderungen ueber den Review-Prozess einreicht, gibt es folgende
   Labels, die RMs (und andere) vergeben koennen:
   a) Code-Review
    -2 Dies darf nicht angeschlossen werden (veto)
    -1 Ich wuerde vorziehen, es so nicht anzuschliessen
     0 keine Meinung / keine Ahnung (Default)
    +1 Sieht gut fuer mich aus, aber jemand anders muss genehmigen
    +2 Sieht gut fuer mich aus, anschlussfaehig
    Jeder Vollmagier kann in /d/ Werte von -1 bis +1 vergeben.
    Zustaendige RMs (und EM+) koennen Werte von -2 bis +2 vergeben (sprich: sie
    duerfen auch ein Veto einlegen).
    Vergibt jemand -2, kann diese Aenderung nicht ins MG gehen, bis diese
    Meinung geaendert/geloescht wurde.
    Eine +2 ist noetig, damit eine Aenderung ins MG geschoben werden kann.

   b) Balance-Genehmigung
    -1 Benoetigt, aber liegt nicht vor
     0 Keine benoetigt (Default)
    +1 Benoetigt und liegt vor
    Jeder Vollmagier darf alle diese Werte vergeben. -1 blockiert den
    Anschluss, 0 und +1 geben ihn frei.

7) Wie bekommen ich einen Magier dazu, meine Aenderung zu reviewen?
   Gute Frage. ;-) Im Ernst: euer RM sollte es von sich aus tun, aber es
   schadet nix, kurz Bescheid zu geben - speziell, wenn es eilig ist.
   Ihr koennt auch jemanden zum Review einladen, sowohl auf der Weboberflaeche
   wie auch per Kommandozeile:
   https://mg.mud.de/gerrit/Documentation/intro-user.html#adding-reviewers
   ssh mgg gerrit set-reviewers

8) Wie kann ich die Commits eines Projekt im Web angucken?
   In der Projektliste dem Link zu gitweb in der ganz rechten Spalte folgen.
   Oder: https://mg.mud.de/gerrit/gitweb?p=d%2Fanfaenger%2Fennox%2Ftutorial.git;a=summary

9) Wie kann ich Aenderungen in einem Projekt verfolgen?
   Im gitweb eines Projektes kann man RSS- und Atom-Feeds abonnieren.

10) Kann ich Aenderungen im Review aendern?
    (Was sind diese Change-IDs?)
   Klar - das geht, wenn der neue/geaenderte Commit die gleiche sog. Change-ID
   hat wie der alte.
   Details:
   https://mg.mud.de/gerrit/Documentation/user-changeid.html

11) Wie bekomme ich Schreibrechte?
   Fuer eure eigenen Projekte in /d/ und /players/ bekommt ihr normalerweise
   automatisch die Rechte als Projekteigentuemer. Damit koennt ihr sogar nicht
   nur Inhalt pushen, sondern auch Projekteinstellungen (inkl. Zugriffsrechte)
   aendern. (Warnung: und euch selber aussperren.)
   Als Projekteigentuemer duerft ihr auch in den meisten Projekten den
   Review-Prozess umgehen. (Was aber vielleicht nicht immer sinnvoll und
   manchmal nichtmals einfacher ist.)
   (BTW: wenn ihr als Projekteigentuemer zuviel Unfug macht und RMs/EMs damit
    unnoetig Arbeit, koennt ihr diese Rechte verlieren...)
   Was ihr aber auch als Projekteigentuemer nicht duerft (weil das die
   Synchronisation mit dem MG zerstoert), ist ein "forced push" in master,
   d.h. ein push, der die Geschichte von master aendert.

12) Ich bin aber in /d/ebene/<ich>/<dings> nicht Eigentuemer?
   Dann wurde das Projekt vermutlich mit einer alten Version des
   Importscriptes angelegt - das hat das leider noch nicht gemacht.
   In diesem Fall wendet euch an den RM und bittet, euch als
   Projekteigentuemer aufzunehmen.
   (Alternativ koennt ihr diese Aenderung tatsaechlich selber vornehmen und
    dann im Reviewprozess speichern. Der RM kann diese Aenderung mit einem
    Befehl freigeben.)

13) Ich moechte ein secure/ in meinem Projekt anlegen / loeschen.
   Schau mal in die Manpage gerrit-secure.

14) Wie kann ich einem Magier (Benutzer) Rechte zuweisen?
   Gerrit kann nur Gruppen Rechte geben, keinen einzelnen Benutzern. Wenn es
   noetig ist, einem einzelnen Magier/Benutzer Rechte zuzuweisen, wird dafuer
   eine Gruppe u_<magiername> benutzt, welche standardmaessig nur diesen
   Magier enthaelt.
   Dies ermoeglicht es allerdings auch, einen Magier B fuer alle Projekte von
   Magier A zustaendig zu machen, indem man u_A die Gruppe u_B hinzufuegt.
   BTW: Wenn ihr keine Rechte habe, obwohl u_<du> Rechte eingeraeumt werden,
   pruefe mal, ob Du ueberhaupt Mitglied in Gruppe u_<du> bist...

15) Was hat es mit den Zweigen refs/heads/players/<magier>/* auf sich?
   Unterhalb von refs/heads/players/<magier>/ darf ein Magier in allen
   Projekten (in denen er was lesen kann) Zweige erstellen, veraendern und
   loeschen. Es muss auch nicht durch einen Review. Diese Zweige werden auch
   nicht ins MG synchronisiert.
   Sprich: die perfekte Spielwiese zum Ausprobieren von Dingen oder um etwas
   fuer das Projekt zu entwickeln, was man spaeter zum Review einreichen
   oder mergen moechte.
   Aber eine Bitte: wenn ihr einen Zweig dort nicht mehr benoetigt, loescht
   ihn bitte wieder. ;-)

16) Gibts das User-Interface fuer den Review auch einfacher?
   Es gibt zumindest eine Erklaerung mit Bildchen, was da dargestellt ist.
   Vielleicht hilft sie euch:
   https://mg.mud.de/gerrit/Documentation/user-review-ui.html
   Man kann Aenderungen editieren, Kommentare an einzelne Zeilen heften etc.