Readme - Poradnik i etykieta jak dodawać wartość do repozytorium unikając chaosu

[scorpionate]

W repozytorium warto dodać poradnik w pliku README.md, który będzie zawierał informacje dotyczące instrukcji dodawania materiałów wedle ustalonego zbioru zasad, według których będą nazywane issues i PR, aby zapewnić jasność i spójność w zarządzaniu projektem.

Proponowane etykiety:
Etykieta: Aktualizacja
Opis: Wymaga aktualizacji istniejących dokumentów prawnych, np. ze względu na zmiany w przepisach lub nowe wytyczne.

Etykieta: Poprawka
Opis: Wskazuje na potrzebę poprawki w istniejącym dokumencie prawnym.

Etykieta: Pytanie
Opis: Dotyczy zadawania pytań lub prośby o wyjaśnienia dotyczące konkretnego dokumentu prawnego.

Etykieta: Ustawa
Opis: Dotyczy problemów, pytań lub dyskusji na temat konkretnych ustaw, które mają związek z dokumentami prawnymi w repozytorium.

Etykieta: Analiza
Opis: Dotyczy prośby o analizę danego dokumentu prawnego pod kątem zgodności z przepisami lub wytycznymi.

Etykieta: Inne
Opis: Dotyczy kwestii, które nie pasują do żadnej z powyższych kategorii.

[AnnaTomala]

Ponawiam pytanie. Czy mogę przesłać swoje uwagi mailowo?

Jeśli tak, proszę o adres. O zanonimizowaniu i umieszczeniu w takiej formie lub uwzględnieniu zadecydują admini.

[scorpionate]

Pytanie do @TomaszMentzen @ProjektyUstawPodatkowych @BartoszPrzybysz, jako że oni widnieją jako założyciele repozytorium.

[BartoszPrzybysz]

Jesteśmy otwarci na propozycję, które ułatwią nam pracę - prosimy o kontakt.

[czlowiek488]

@scorpionate dodałeś maile "no reply" 😆
@AnnaTomala już ci odpisałem w innym wątku
Co to tematu tego issue, dostałbym też templatke przy tworzeniu issue. Odfiltrowałoby to mniej sensowne propozycje i narzuciło jakiś standard.

[scorpionate]

@czlowiek488 Racja, nie doczytałem, puściłem FF 😄

[czlowiek488]

@lemonglutton @scorpionate
W takim razie widzę 2 opcje które można rozważyć.

Labelka musi zostać sama dodana do listy labelek w repozytorium przez osobę z podwyższonymi uprawnieniami - https://github.com/ProjektyUstaw/Ustawy-o-PIT/labels

Następnie widzę 2 opcje:

1. Społeczność może przygotować gotowe templatki powiązane z odpowiednimi labelkami, dzięki temu labelki będą dołączane do issues automatycznie.
2. Osoba z podwyższonymi uprawnieniami dodaje ręcznie labelki do każdego issue.

[scorpionate]

Ja jestem za. Ogólnie rzucam temat, ale to też trzeba usłyszeć zdanie @BartoszPrzybysz i @ProjektyUstawPodatkowych . NIe ma sensu robić overkill engineering jak nikt tym z góry nie będzie zarządzać i moderować.

[lemonglutton]

Ja jestem za. Ogólnie rzucam temat, ale to też trzeba usłyszeć zdanie @BartoszPrzybysz i @ProjektyUstawPodatkowych . NIe ma sensu robić overkill engineering jak nikt tym z góry nie będzie zarządzać i moderować.

@czlowiek488 @BartoszPrzybysz
O właśnie to @scorpionate, mam podobne zdanie. Trzeba by z nimi przede wszystkim pogadać jak według nich miałaby wyglądać współpraca w tym projekcie - na dobry początek np jakie są oczekiwania z ich strony, czy i jak chcieliby podzielić się odpowiedzialnością za projekt, jak widzieliby dalszy rozwój tego projektu, a następnie skonfrontować to z rzeczywistością. To są ważne kwestie, które wypadałoby omówić, zanim zrobi się cokolwiek. Nie ma co cisnąć na siłę, a skoncentrować energię na kwestiach istotnych.

[AnnaTomala]

Jesteśmy otwarci na propozycję, które ułatwią nam pracę - prosimy o kontakt.

Proszę o maila (prywatnego lub zbiorczego, dedykowanego projektowi). Tu nie mam możliwości wysłania prywatnej wiadomości.

[piotr-calus]

W repozytorium warto dodać poradnik w pliku README.md, który będzie zawierał informacje dotyczące instrukcji dodawania materiałów wedle ustalonego zbioru zasad, według których będą nazywane issues i PR, aby zapewnić jasność i spójność w zarządzaniu projektem.

Warto spolszczyć nazwy i opisy kategorii w Dyskusjach oraz wspomnieć o nich w pliku z zaleceniami dotyczącymi współudziału w projekcie - README.md lub osobnym, podłączonym w README.

Moim zdaniem to właśnie do Dyskusji powinny być kierowane pierwsze kroki nowych osób, zwłaszcza w celu zgłaszania "skarg i żalów". Szczególnie, że późniejsze odwołanie się do całej dyskusji lub konkretnego komentarza z wnioskami nie stanowi najmniejszego problemu -- każdy komentrz ma nawet osobną opcję utworzenia nowego zgłoszenia na jego podstawie - Reference in new issue.