Document r1 and token.json auth paths

README.md

@@ -24,7 +24,36 @@ git clone http://77.90.8.171:3001/edu-tools/rv-launcher.git
 cd rv-launcher
 ```
 
-## Najpierw token
+## Autoryzacja
+
+Masz dwie drogi.
+
+### Droga 1: remote `r1` z tokenem w URL
+
+To jest wariant dydaktyczny, jesli uczen ma cwiczyc reczne dodawanie remota z
+tokenem do konkretnego zdalnego endpointu.
+
+Przyklad:
+
+```bash
+git remote add r1 http://u1:TOKEN@77.90.8.171:3001/edu-tools/rv-launcher.git
+git fetch r1 main
+git switch main
+git pull --ff-only r1 main
+```
+
+Jesli po zajeciach uzytkownik bedzie chcial wyslac projekt na swoje konto
+Gitea, moze zmienic URL remota `r1` na swoje repo:
+
+```bash
+git remote set-url r1 http://LOGIN:TOKEN@77.90.8.171:3001/LOGIN/rv-launcher.git
+```
+
+### Droga 2: lokalny `tokens/gitea_tokens.json`
+
+To jest wariant alternatywny, wygodniejszy wtedy, gdy launcher ma sam wykonywac
+`clone`, `fetch` i `push`, albo gdy uzytkownik po zajeciach chce pracowac juz na
+wlasnych repo bez wpisywania tokena do kazdego remota.
 
 Przed operacjami wymagajacymi autoryzacji dodaj lokalny token do:
 
@@ -68,6 +97,14 @@ git switch main
 git pull --ff-only
 ```
 
+Jesli pracujesz przez `r1`, odpowiednikiem jest:
+
+```bash
+git fetch r1 main
+git switch main
+git pull --ff-only r1 main
+```
+
 Jesli chcesz wejsc na inna galaz, na przyklad `feat/x`, uzyj:
 
 ```bash
@@ -75,6 +112,13 @@ git fetch origin feat/x
 git switch --track -c feat/x origin/feat/x
 ```
 
+Wariant przez `r1`:
+
+```bash
+git fetch r1 feat/x
+git switch --track -c feat/x r1/feat/x
+```
+
 ## Podstawowe komendy
 
 Przyklady:

doc/usage.md

@@ -25,7 +25,32 @@ Jesli w Twoim workspace narzedzia sa poza `rv/`, analogiczny katalog to:
 ~/dev/workspace/tools/rv-launcher
 ```
 
-### Najpierw token
+### Autoryzacja
+
+Masz dwie drogi.
+
+#### Droga 1: remote `r1` z tokenem w URL
+
+To jest wariant dydaktyczny, jesli uczen ma cwiczyc reczne dodawanie remota z
+tokenem do zdalnego endpointu.
+
+Przyklad:
+
+```bash
+git remote add r1 http://u1:TOKEN@77.90.8.171:3001/edu-tools/rv-launcher.git
+git fetch r1 main
+git switch main
+git pull --ff-only r1 main
+```
+
+Jesli po zajeciach uzytkownik bedzie chcial wysylac projekty na swoje konto
+Gitea, moze przepiac remote `r1` na wlasne repo:
+
+```bash
+git remote set-url r1 http://LOGIN:TOKEN@77.90.8.171:3001/LOGIN/rv-launcher.git
+```
+
+#### Droga 2: lokalny `tokens/gitea_tokens.json`
 
 Przed operacjami wymagajacymi autoryzacji dodaj lokalny token do:
 
@@ -57,6 +82,11 @@ chmod 700 ~/dev/workspace/rv/tokens
 chmod 600 ~/dev/workspace/rv/tokens/gitea_tokens.json
 ```
 
+Wariant z `tokens/gitea_tokens.json` jest wygodniejszy wtedy, gdy launcher ma
+sam wykonywac `clone`, `fetch` i `push`, albo gdy uzytkownik po zajeciach chce
+pracowac z wieloma repo na swoim koncie bez wpisywania tokena do kazdego
+remota.
+
 ### Fetch i switch
 
 Domyslna galaz launchera to `main`.
@@ -69,6 +99,14 @@ git switch main
 git pull --ff-only
 ```
 
+Wariant przez `r1`:
+
+```bash
+git fetch r1 main
+git switch main
+git pull --ff-only r1 main
+```
+
 Jesli chcesz wejsc na inna galaz, na przyklad `feat/x`, uzyj:
 
 ```bash
@@ -76,6 +114,13 @@ git fetch origin feat/x
 git switch --track -c feat/x origin/feat/x
 ```
 
+Wariant przez `r1`:
+
+```bash
+git fetch r1 feat/x
+git switch --track -c feat/x r1/feat/x
+```
+
 ## Wywolanie glowne
 
 ```bash