Clarify tasks in series docs

This commit is contained in:
mpabi
2026-04-29 01:21:44 +02:00
parent d50a6e1919
commit 970219f445
+10 -5
View File
@@ -1,17 +1,18 @@
# Series
Ten dokument opisuje docelowy model komend `rvctl` do pracy z seriami i
kartami pracy.
Ten dokument opisuje docelowy model komend `rvctl` do pracy z seriami, kartami
pracy i zadaniami w kartach.
## Zasada
Komendy kart pracy dzielimy na dwa poziomy:
Komendy kart pracy dzielimy na trzy poziomy:
- `series` - operacje na serii jako calosci
- `series cards` - operacje na kartach w ramach serii
- `series cards tasks` - operacje na zadaniach w ramach karty
Uzywamy `cards`, a nie `card`, bo namespace opisuje kolekcje kart i jest
spojny z pluralnym `tokens`.
Uzywamy pluralnych namespace'ow `cards` i `tasks`, bo opisuja kolekcje zasobow
i sa spojne z pluralnym `tokens`.
## Szybki Flow
@@ -113,6 +114,7 @@ source_path ~/dev/edu/repos/rv/series/inf/03
source_repo edu-inf/lab-rv32i-strlen-bss-data-stack
source_remote r1
answer_remote a1
tasks task1 task2 ...
```
### `series cards fetch SERIES CARD`
@@ -187,4 +189,7 @@ list-cards inf -> series cards list inf
submission inf 03 --class K --nick N -> series cards submission inf 03 --class K --nick N
```
Komendy `series cards tasks ...` nie maja starego odpowiednika i powinny byc
wprowadzane tylko w nowym namespace.
Dokumentacja i nowe przyklady powinny promowac namespace `series`.