Clarify quick start prerequisites

This commit is contained in:
mpabi
2026-04-29 02:27:42 +02:00
parent 46f2f44118
commit e179ed1549
+19 -9
View File
@@ -284,20 +284,12 @@ Najpierw zobacz konfigurację i dostępne komendy:
./rvctl show-config
```
Typowy przepływ pracy:
Po konfiguracji tokenów najpierw sprawdź stan store:
```bash
./rvctl tokens compare
./rvctl list-series
./rvctl list-cards inf
./rvctl tmux-container inf 03 --dry-run
./rvctl tmux-container inf 03 --session rv-inf03 --attach
./rvctl submission inf 03 --class 4i --nick u1
```
`--dry-run` jest przydatny przy sprawdzaniu planu uruchomienia lub konfiguracji
repo, zanim narzędzie coś zmieni.
### Po pobraniu kart pracy
Karty trafiają do `series` w workspace:
@@ -316,6 +308,14 @@ Karty trafiają do `series` w workspace:
`rvctl` pracuje na kartach z `series_root`, czyli na katalogu
`~/dev/workspace/rv/series`.
Od tego momentu możesz listować serie i karty:
```bash
./rvctl list-series
./rvctl list-cards inf
./rvctl submission inf 03 --class 4i --nick u1
```
### Po uruchomieniu środowiska kontenerowego
Repo `rv32i-hazard3-env` jest potrzebne dopiero przy uruchamianiu środowiska
@@ -337,6 +337,16 @@ Repozytoria źródłowe poza workspace, na przykład `~/dev/edu/repos/rv`, są
zapleczem dla autora materiałów albo fallbackiem dla narzędzi. Nie są wymagane
do zwykłej pracy w workspace.
Przykładowe komendy dla środowiska kontenerowego:
```bash
./rvctl tmux-container inf 03 --dry-run
./rvctl tmux-container inf 03 --session rv-inf03 --attach
```
`--dry-run` jest przydatny przy sprawdzaniu planu uruchomienia lub konfiguracji
repo, zanim narzędzie coś zmieni.
## Dokumentacja
- `doc/rvctl.md` - techniczna dokumentacja CLI: wszystkie komendy, argumenty