diff --git a/doc/tokens.md b/doc/tokens.md
index 3867ca2..01e35f7 100644
--- a/doc/tokens.md
+++ b/doc/tokens.md
@@ -1,19 +1,16 @@
 # Tokens
 
-Ten dokument opisuje praktyczna obsluge tokenow Gitea w `rvctl`.
+`rvctl` obsluguje tokeny Gitea w dwoch miejscach:
 
-`rvctl` traktuje `tokens.json` jako lokalny store tokenow. Rekord tokena zawiera
-sekret, endpoint serwera, login uzytkownika oraz docelowe `org/repo`. Git remote
-jest tylko miejscem, z ktorego token mozna jednorazowo wczytac albo do ktorego
-mozna go tymczasowo wpisac, gdy Git ma wykonac `fetch` albo `push`.
+- `tokens.json` - lokalny store sekretow i metadanych tokenow
+- `.git/config` - git remotes w konkretnym repo
 
-Operacyjnie sa dwa zrodla stanu:
+Rekord w `tokens.json` zawiera token, endpoint serwera, login oraz docelowe
+`org/repo`. Git remote sluzy tylko do operacji Git (`fetch`, `push`) albo do
+pierwszego wczytania tokena do store.
 
-- `tokens.json` - lokalny store sekretow i metadanych API
-- `.git/config` - konfiguracja git remotes w wybranym repo
-
-`rv-launcher` jest domyslnym repo, na ktorym dzialaja komendy tokenow bez
-`--repo`. Dla kart pracy albo innych repo trzeba podac `--repo PATH`.
+Bez `--repo` komendy tokenow dzialaja na repo `rv-launcher`. Dla kart pracy albo
+innych repo podaj `--repo PATH`.
 
 ## Szybki Flow