From 8bedc727afb6f50ce2dfc4c45a7a33029fecdbbe Mon Sep 17 00:00:00 2001
From: mpabi <mpabi@mpabi.pl>
Date: Sun, 26 Apr 2026 09:33:34 +0200
Subject: [PATCH] Document r1 and token.json auth paths

---
 README.md    | 46 +++++++++++++++++++++++++++++++++++++++++++++-
 doc/usage.md | 47 ++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 91 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index d56f3f7..08c74c3 100644
--- a/README.md
+++ b/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:
diff --git a/doc/usage.md b/doc/usage.md
index 80d4b97..537ffe1 100644
--- a/doc/usage.md
+++ b/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