search

apoikola / avoindata-opaskirja

Julkinen data oppaan versiot ja käännökset
http://www.julkinendata.fi/
5 stars 0 forks source link

oma branch päivitetylle versiolle #6

Open apoikola opened 11 years ago

apoikola commented 11 years ago

Luku 2.2. on uudelleenkirjoitettuna täällä

https://gist.github.com/apoikola/912647

pe3 commented 11 years ago

Vois olla fiksua sopia kirjan päivittämiselle jonkinlainen bränchäämis-käytäntö, tyyliin ohjelmistokoodille kehitetty semantic versioning. Onkohan jotakin valmista jo olemassa kirjan kirjoittamiselle ping @jlehtoma

jlehtoma commented 11 years ago

@pe3 eipä ole tullut vastaan mitään just kirjan kirjoittamiselle tarkoitettua, mutta tämmöinen tuli vastaan:

Book Authoring Using GitHub and Git

Semantic versioning ihan jees, mutta en oo ihan varma toimivatko kaikki analogiat kirjan kirjoittamisen puolella:

  1. MAJOR version when you make incompatible API changes,
  2. MINOR version when you add functionality in a backwards-compatible manner, and
  3. PATCH version when you make backwards-compatible bug fixes.

olisko nää sitten jotain tyyliin:

  1. MAJOR modify the book structure (e.g. merge/replace chapters)
  2. MINOR modify individual chapters (add/remove text, pictures etc)
  3. PATCH fix typos etc
pe3 commented 11 years ago

Joo mäkin mielessäni epäilin analogian toimivuutta kirjalle, mutta nyt kun muotoilit sen noin, ei tunnu yhtään mahdottomalta. Eli 1-taso: koko kirjan rakenne muuttuu, 2-taso: yksittäisen luvun rakenne / flow / kuvitus / taitto muuttuu 3-taso: sanavalinnat, kielen selkeys, kirjoitusvirheet,...

pe3 commented 11 years ago

Edelläkuvatulla logiikalla luvun 2.2-päivitys liittyisi branchiin, joka tähtää kirjan 1.1 version tuottamiseen.

apoikola commented 11 years ago

mulla on vielä nämä hommat sen verran hakusessa, etten ole eläessäni mitään oikeasti branchannut (saatika mergettänyt), että sinänsä fiksunkuuloiset bränchäämiskäytäntökuvaukset eivät vielä kerro minulle, mitä ihan konkreettisesti pitäisi / kannattaisi tehdä?