Co wchodzi do wiki
Wiki trzyma tylko to, czego nie ma w GitHubie, Linearze, na Drive ani w CRM.
Co NIE wchodzi
| Treść | Gdzie należy |
|---|---|
| dokumentacja kodu, README, ADR w repo | GitHub |
| zadania, bugi, roadmapa | Linear |
| oferty, umowy, transkrypcje, dokumenty klienckie | Google Drive |
| pipeline sprzedażowy, ownerzy sprzedażowi | CRM |
| sekrety, klucze, hasła | 1Password (w wiki tylko nazwa vaulta) |
Wyjątek dla dokumentacji kodu: standardy dotyczące wielu repo.
Półki
| Półka | Co w niej | Struktura |
|---|---|---|
| Firmy | klienci, vendorzy, partnerzy | książka per firma, w środku strona Kontakty |
| Projekty i narzędzia | wdrożenia klienckie, projekty wewnętrzne, narzędzia | książka per projekt / narzędzie |
| Inne | standardy pracy, procesy wewnętrzne | książka per temat |
Jeśli książka w Inne zaczyna dotyczyć jednej firmy albo jednego projektu — przenosimy ją na właściwą półkę. Inne nie jest składowiskiem.
Tagi
| Tag | Wartości | Gdzie |
|---|---|---|
rola |
klient / vendor / partner |
książka firmy |
typ |
klient / wewnetrzny / narzedzie |
książka projektu |
klient |
slug firmy, np. onerent |
książka projektu |
status |
w-budowie / aktywny / utrzymanie / wygaszony |
książka projektu |
owner |
imie.nazwisko |
książka projektu, książka firmy |
Nie dodajemy pola „ostatnia aktualizacja" — BookStack pokazuje je sam.
Zasady
- Nowa książka zawsze z szablonu — patrz strony
Szablon — ...w tej książce. - Lista projektów firmy to link do wyszukiwania po tagu
klient, nie ręczna lista. - Trzymamy się MINIMALIZMU - przechowujemy tu minimum istotnych informacji, żebyśmy nie utoneli w wyhalucynowanym slopie.