Separate source repos from workspace clones

doc/workspace.md

@@ -2,15 +2,44 @@
 
 Plik opisuje przelaczniki i liste komend skryptu `workspace.py`.
 
+## Model katalogow
+
+Repo oryginalne trzymamy poza workspace:
+
+```bash
+~/dev/rv/repos
+```
+
+Workspace sluzy do klonow roboczych i cwiczen:
+
+```bash
+~/dev/workspace/rv
+```
+
+Typowy uklad:
+
+```text
+~/dev/rv/repos/rv-launcher
+~/dev/rv/repos/rv32i-hazard3-env
+~/dev/workspace/rv/tools/rv-launcher
+~/dev/workspace/rv/tools/rv32i-hazard3-env
+~/dev/workspace/rv/series/<seria>/<karta>
+```
+
+`workspace.py` czyta karty z `series_root` w workspace. Tool repo
+`rv32i-hazard3-env` wybiera najpierw z workspace, a potem z fallbacku
+`~/dev/rv/repos` lub `~/dev/rv/tools`, jesli taki klon roboczy jeszcze nie
+istnieje.
+
 ## Pobranie repo i przelaczenie galezi
 
-Jesli trzymasz tool repo pod:
+Repo treningowe launchera trzymaj pod:
 
 ```bash
 ~/dev/workspace/rv/tools/rv-launcher
 ```
 
-to podstawowy bootstrap wyglada tak:
+Podstawowy bootstrap wyglada tak:
 
 ```bash
 mkdir -p ~/dev/workspace/rv/tools
@@ -19,12 +48,6 @@ git clone http://77.90.8.171:3001/edu-tools/rv-launcher.git
 cd rv-launcher
 ```
 
-Jesli w Twoim workspace narzedzia sa poza `rv/`, analogiczny katalog to:
-
-```bash
-~/dev/workspace/tools/rv-launcher
-```
-
 ### Autoryzacja
 
 Masz dwie drogi.
@@ -155,6 +178,7 @@ Typowy format:
 
 ```text
 config_path<TAB>...
+original_root<TAB>...
 workspace_root<TAB>...
 series_root<TAB>...
 socket_root<TAB>...