To tak dla przybliżenia sytuacji z wiki (https://github.com/autyzm-pg/mroza/issues/36):
Na githubiue wiki hostowane jest osobno i za bardzo nie widać możliwości robienia do niego pull requestów.
Jak wspominała Gosia, bez pull reqestów jest to raczej mało wygodne i można by dodać instrukcję albo wiki jako pliki do repozytorium.
Osobiście jestem za. Dla ułatwienia dostępu poźniej można byłoby wstawić linki do plików na repozytorium, na stronach wiki.
Co o tym sądzicie?

To tak dla przybliżenia sytuacji z wiki (https://github.com/autyzm-pg/mroza/issues/36): Na githubiue wiki hostowane jest osobno i za bardzo nie widać możliwości robienia do niego pull requestów. Jak wspominała Gosia, bez pull reqestów jest to raczej mało wygodne i można by dodać instrukcję albo wiki jako pliki do repozytorium. Osobiście jestem za. Dla ułatwienia dostępu poźniej można byłoby wstawić linki do plików na repozytorium, na stronach wiki. Co o tym sądzicie?

Myślałam trochę o tym i znalazłam coś takiego https://help.github.com/articles/adding-and-editing-wiki-pages-locally/. Z tego co rozumiem, można pushować do wiki, ale github nie wspiera jeszcze pull requestów. Tutaj proponują rozwiązanie: http://fusiongrokker.com/post/how-you-can-contribute-to-taffy-documentation
W sumie to zrobiłeś. Tylko można byłoby to usystematyzować.
Albo jest też możliwość trzymania dwóch wersji, na repo i na wiki. Tylko wtedy jest ryzyko, że staną się one z czasem niespójne. Wtedy linki na wiki wydają się być lepszym rozwiązaniem.

Myślałam trochę o tym i znalazłam coś takiego https://help.github.com/articles/adding-and-editing-wiki-pages-locally/. Z tego co rozumiem, można pushować do wiki, ale github nie wspiera jeszcze pull requestów. Tutaj proponują rozwiązanie: http://fusiongrokker.com/post/how-you-can-contribute-to-taffy-documentation W sumie to zrobiłeś. Tylko można byłoby to usystematyzować. Albo jest też możliwość trzymania dwóch wersji, na repo i na wiki. Tylko wtedy jest ryzyko, że staną się one z czasem niespójne. Wtedy linki na wiki wydają się być lepszym rozwiązaniem.

Myślę, że tak jak to zrobiłeś @Ro-Ze to najlepszy sposób obecnie smile Przejrzeć i rozwiązać takiego pull requesta można analogicznie do zmian w kodzie i wszystko powinno grać smile

Czyli przyjmujemy taką koncepcję: http://fusiongrokker.com/post/how-you-can-contribute-to-taffy-documentation

Myślę, że tak jak to zrobiłeś @Ro-Ze to najlepszy sposób obecnie :) Przejrzeć i rozwiązać takiego pull requesta można analogicznie do zmian w kodzie i wszystko powinno grać :D Czyli przyjmujemy taką koncepcję: http://fusiongrokker.com/post/how-you-can-contribute-to-taffy-documentation

Dobra to tak robimysmile Zaraz rozwiąże tego pull requesta. Co robimy z katalogiem doc?

Dobra to tak robimy:) Zaraz rozwiąże tego pull requesta. Co robimy z katalogiem doc?

Myślę, że można by z niego zrezygnować - trzeba założyć issue żeby przenieść dokumentację z doc na wiki smile

Myślę, że można by z niego zrezygnować - trzeba założyć issue żeby przenieść dokumentację z doc na wiki :)

Podpinam się pod opinie i w pełni popieram. smile
Co do przeniesienia dokumentacji z katalogu doc, do wiki też jestem za. Na początku, przy oswajaniu się z projektem wybadałem tylko strony na wiki i pewnie gdyby nie hint od @malsolec, przeoczyłbym całkowicie katalog doc.

A odnośnie dalszych aktualizacji wiki, myślałem, żeby w międzyczasie rozwinąć jeszcze trochę opis konfiguracji eclipse i dorzucić konfigurację wildfly z postgresql jako źródłem danych (z tego co pamiętam bez wsparcia intellij'a trzeba było to ręcznie ustawić).
Osobiście zawsze irytowałem się, walką z ustawieniem środowiska, więc chętnie oszczędziłbym tego przyszłym developerom. smile
Co o tym sądzicie? Wypadałoby dodać coś jeszcze do wiki, albo zwrócić na coś uwagę?

Podpinam się pod opinie i w pełni popieram. :) Co do przeniesienia dokumentacji z katalogu doc, do wiki też jestem za. Na początku, przy oswajaniu się z projektem wybadałem tylko strony na wiki i pewnie gdyby nie hint od @malsolec, przeoczyłbym całkowicie katalog doc. A odnośnie dalszych aktualizacji wiki, myślałem, żeby w międzyczasie rozwinąć jeszcze trochę opis konfiguracji eclipse i dorzucić konfigurację wildfly z postgresql jako źródłem danych (z tego co pamiętam bez wsparcia intellij'a trzeba było to ręcznie ustawić). Osobiście zawsze irytowałem się, walką z ustawieniem środowiska, więc chętnie oszczędziłbym tego przyszłym developerom. :) Co o tym sądzicie? Wypadałoby dodać coś jeszcze do wiki, albo zwrócić na coś uwagę?

Tak, trzeba to koniecznie poprzerzucać. Doc był zrobiony na wzór innych projektów, ale one też miały wiki.
Moim zdaniem, najlepiej do wiki byłoby wrzucać wszystko. Cokolwiek nad czym się zastanawialiśmy chwilę i chcemy się tym podzielić. Nawet rzeczy dla nas oczywiste mogą być nieoczywiste dla innych. smile

Tak, trzeba to koniecznie poprzerzucać. Doc był zrobiony na wzór innych projektów, ale one też miały wiki. Moim zdaniem, najlepiej do wiki byłoby wrzucać wszystko. Cokolwiek nad czym się zastanawialiśmy chwilę i chcemy się tym podzielić. Nawet rzeczy dla nas oczywiste mogą być nieoczywiste dla innych. :D
259
views
6
replies
3
followers
live preview
enter atleast 10 characters
WARNING: You mentioned %MENTIONS%, but they cannot see this message and will not be notified
Saving...
Saved
All posts under this topic will be deleted ?
Pending draft ... Click to resume editing
Discard draft