/pl/przewodnik

GitHub dla czytelników ustaw

GitHub to serwis, w którym udostępnia się pliki i zapisuje każdą ich zmianę. Programiści trzymają tam programy, my — ustawy z komentarzem. Ten przewodnik pokaże wszystko, czego potrzebujesz do czytania — bez konta i bez jednej linijki kodu.

  1. Otwórz repozytorium ustawy

    W katalogu kliknij ustawę, która cię interesuje. Otworzy się repozytorium — folder projektu na GitHubie. U góry widzisz listę plików, pod nią automatycznie wyświetla się README: strona startowa, która podaje stan prawny (tekst jednolity z Dziennika Ustaw) i liczbę skomentowanych artykułów. Pliki leżą na jednym poziomie, bez podfolderów.

  2. Czytaj rozdziały jak strony internetowe

    Pliki z rozszerzeniem .md („markdown" — czysty tekst z prostym formatowaniem) GitHub wyświetla sformatowane: z nagłówkami i cytatami. Wystarczy kliknąć nazwę pliku i czytać. Wracasz strzałką przeglądarki.

    Wskazówka: nad tekstem jest ikona spisu treści (trzy kreski) — rozwija konspekt rozdziału, z którego przejdziesz prosto do poszczególnych artykułów.

  3. Znajdź swój artykuł

    Na górze strony repozytorium jest pole z lupą („Go to file" / wyszukiwanie). Kliknij je i wpisz, czego szukasz — GitHub podpowie pliki i miejsca w tekście. Możesz szukać numeru artykułu albo słów z komentarza. Jeśli chcesz najpierw zobaczyć, w którym rozdziale leży twój artykuł, otwórz INDEX.md: przy każdym rozdziale podany jest zakres artykułów.

    Wskazówka: klawisz T na stronie repozytorium otwiera szybkie wyszukiwanie plików; Ctrl+F szuka w otwartym rozdziale.

  4. Zobacz, co i kiedy się zmieniło

    Prawo się zmienia — a tu widać jak. Przycisk History (przy każdym pliku w prawym górnym rogu) pokazuje listę wszystkich zmian: kiedy nastąpiły i co dokładnie się zmieniło, linijka po linijce. Żadnego cichego przepisywania; każda wersja tekstu pozostaje dostępna.

  5. Pobierz, czego potrzebujesz

    Cały komentarz: zielony przycisk CodeDownload ZIP. Pojedynczy rozdział: przycisk Raw pokaże czysty tekst, który zapiszesz skrótem Ctrl+S albo od razu wydrukujesz z przeglądarki.

  6. Włącz się (jedyny krok, który wymaga konta)

    Z bezpłatnym kontem na GitHubie możesz w zakładce Issues zgłosić błąd albo zadać pytanie do komentarza — publicznie, więc odpowiedź przyda się też innym. Gwiazdka (Star) zapisze repozytorium w ulubionych, Watch wyśle powiadomienie o każdej zmianie.

/slowniczek

Słowniczek pojęć

repozytorium
Folder projektu na GitHubie. Tutaj: jedna ustawa = jedno repozytorium.
markdown (.md)
Czysty tekst z prostym oznaczeniem nagłówków i cytatów. GitHub wyświetla go sformatowany.
README
Plik startowy repozytorium — stan prawny (tekst jednolity z Dz.U.) i zakres komentarza.
INDEX.md
Wykaz wszystkich rozdziałów komentarza z zakresem artykułów w każdym z nich.
commit
Jedna zapisana zmiana tekstu, z datą i opisem. Z commitów składa się historia.
Issue
Publiczne zgłoszenie: błąd albo pytanie do komentarza. Wymaga bezpłatnego konta.
Raw
Widok czystego tekstu pliku — do zapisania albo wydruku.

Wróć do katalogu — wybierz ustawę