celem jest posiadanie systemu dokumentacji online z tymi głównymi wymaganiami:
- będą wykorzystywane głównie jako etap pośredni dla końcowych dokumentów technicznych wszystkich naszych aplikacji (które prawdopodobnie nigdy się nie zakończą:]). Zwykle byłby używany w ten sposób: ktoś ma problem, naprawiam go i natychmiast zapisuję. To, co się teraz dzieje, staje się niemożliwe do rozwiązania: ktoś ma problem, naprawiam go, zarówno ja, jak i ktoś, jesteśmy szczęśliwi, ale 2 miesiące później ktoś ma ten sam problem i nikt nie pamięta, co to była poprawka.
- dostępne z dowolnego miejsca, działające za naszym serwerem Apache
- zarządzanie użytkownikami / grupami, umożliwiające dostęp tylko do odczytu / odczyt-zapis / administrator
- format nie jest zbyt ważny: wystarczy zwykły tekst, ale styl wiki byłby ładniejszy
- tanie lub darmowe
kilka moich pomysłów:
- po prostu udostępniaj pliki w udziale plików lub przez ssh (wady: niezbyt dające się kopiować w systemie Windows, zalety: proste, może być dowolnego typu pliku)
- trzymaj go w SCM (svn / git, idem jak wyżej, ale łatwiejszy dostęp i kontrola dostępu)
- Confluence: korzystamy już z Jiry, czy Confluence jest tego warte? Jak integruje się z Jira?
- coś innego?
Nie wahaj się komentować lub podzielić się swoimi doświadczeniami z innymi systemami.
documentation
stijn
źródło
źródło
Odpowiedzi:
Chciałem zaproponować Wiki
Ponieważ Confluence to wiki, myślę, że używanie jej z JIRA to doskonały pomysł. Będziesz miał tę zaletę, że będziesz w stanie bezpośrednio związać się z problemami JIRA, a zatem faktycznym kodem / dokumentem / jakąkolwiek zmianą itp.
Kluczem do każdego repozytorium dokumentów kodu takiego jak ten jest aspekt nawigacji. Nie chcesz stron, które są rozłączone, trudne do znalezienia itp. Zastanów się nad „układem strony”, podobnie jak w przypadku witryny internetowej.
źródło