/fi/opas

GitHub lain lukijalle

GitHub on palvelu, jossa tiedostoja jaetaan ja jokainen muutos jää talteen. Ohjelmoijat pitävät siellä ohjelmia, me lakeja kommentaareineen. Tämä opas näyttää kaiken, mitä lukemiseen tarvitaan — ilman tiliä ja ilman yhtään koodiriviä.

  1. Avaa säädöksen tietovarasto

    Luettelosta napsautat lakia, joka kiinnostaa. Avautuu tietovarasto — projektin kansio GitHubissa. Ylhäällä on tiedostolista, sen alla näkyy itsestään README: etusivu, joka kertoo oikeustilan (Finlexin konsolidoitu teksti) ja kommentoitujen yksiköiden määrän. Tiedostot ovat samalla tasolla, ilman alikansioita.

  2. Lue luvut kuin verkkosivuja

    Päätteellä .md olevat tiedostot (« markdown » — pelkkää tekstiä yksinkertaisin merkein) GitHub näyttää muotoiltuina, otsikoineen ja lainauksineen. Riittää, että napsautat tiedoston nimeä. Takaisin pääset selaimen nuolella.

    Vinkki: tekstin yläpuolella on sisällysluettelon kuvake (kolme viivaa) — se avaa luvun jäsennyksen, josta siirryt suoraan pykälään.

  3. Etsi pykäläsi

    Tietovaraston sivun yläreunassa on kenttä, jossa on suurennuslasi (« Go to file »). Napsauta sitä ja kirjoita, mitä etsit: pykälän numero tai sanoja kommentaariosta. Jos haluat ensin nähdä, missä luvussa pykälä on, avaa INDEX.md: jokaisen luvun kohdalla on pykälien väli.

    Vinkki: näppäin T tietovaraston sivulla avaa nopean tiedostohaun; Ctrl+F hakee avoimessa luvussa.

  4. Katso, mikä muuttui ja milloin

    Oikeus muuttuu — ja täällä sen näkee. Painike History (jokaisessa tiedostossa oikealla ylhäällä) listaa kaikki muutokset: milloin ne tapahtuivat ja mikä rivi muuttui. Ei hiljaista uudelleenkirjoitusta; jokainen tekstin versio jää saataville.

  5. Lataa, mitä tarvitset

    Koko kommentaari: vihreä painike Code → Download ZIP. Yksi luku: Raw näyttää pelkän tekstin, jonka tallennat näppäimillä Ctrl+S tai tulostat selaimesta.

  6. Osallistu (ainoa askel, joka vaatii tilin)

    Maksuttomalla GitHub-tilillä voit avata välilehdellä Issues virheen tai kysymyksen kommentaariin — julkisesti, jotta vastaus hyödyttää muitakin. Tähti (Star) tallentaa tietovaraston, Watch ilmoittaa jokaisesta muutoksesta.

/sanasto

Sanasto

tietovarasto
Projektin kansio GitHubissa. Tässä: yksi säädös = yksi tietovarasto.
markdown (.md)
Pelkkää tekstiä, jossa otsikot ja lainaukset on merkitty yksinkertaisesti. GitHub näyttää sen muotoiltuna.
README
Aloitustiedosto — oikeustila (Finlexin konsolidoitu teksti) ja kommentaarin laajuus.
INDEX.md
Luettelo kaikista luvuista ja kunkin pykäläväli.
commit
Yksi tallennettu tekstin muutos, päivämäärineen ja kuvauksineen. Historiikki koostuu commiteista.
Issue
Julkinen ilmoitus: virhe tai kysymys kommentaariin. Vaatii maksuttoman tilin.
Raw
Tiedoston pelkän tekstin näkymä — tallentamista tai tulostusta varten.

Takaisin luetteloon — valitse laki