Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Roadmap. Tässä keskustellaan siitä, miten uusia versioita määritelmästä tuotetaan #36

Open
Mygee opened this issue May 16, 2016 · 2 comments

Comments

@Mygee
Copy link
Contributor

Mygee commented May 16, 2016

Avaan keskustelun siitä, miten usein uusi versio määritelmästä tehdään ja miten prosessin pitäisi toimia. Taustaksi. Alkuperäisen määritelmän sisällöstä käytiin keskustelua kuukausia. Määritelmä yritettiin laatia niin, että siinä ei olisi aukkoja. Tarkoituksena oli hyödyntää määritelmää ohjelmistojen hankinnassa. Aiemmin melkein mitä tahansa rajapintaa saatettiin kutsua "avoimeksi rajapinnaksi". Viimeaikoina määritelmän käyttö on laajentunut siihen suuntaan, että sen avulla kehitetään uusia rajapintoja. Määritelmän päivittämisessä haetaan tasapainoa pysyvyyden ja kattavuuden kanssa. Lisäksi halutaan pitää ihmisen motivaatiota osallistua määritelmän tekoon ja hyödyntää määritelmää käytännössä yllä.

@Mygee
Copy link
Contributor Author

Mygee commented May 16, 2016

Ehdotelma muokkausprosessiksi image

@apoikola
Copy link
Member

Kohtaan 2 (ongelmien kerääminen) syöttökanavina muitakin, kuin github-issuet, eli valitaan tietyt kanavat (meililista, drivessa oleva kommentoitava tekstiversio, tapahtumat, yms.) missä voi kertoa ajatuksiaan ja @Mygee ja me muut aktiivit huolehdimme siitä, että identifioidut asiat avataan issueina tänne. Avoinrajapinta.fi sivulla sitten kerrotaan nämä kanavat, missä voi antaa palautetta määritelmään.

"Ryhmä keskustelee" - kohtaan voisi laittaa, että tavataan myös livenä tarvittaessa, voidaan pitää "issueiden clousaus-talkoita" tms.

Tekstin kommentointi Gdocsissa on varmaan tarpeellinen, koska on idioottimaista avata issueita tyyliin kolmannen kappaleen riviltä kaksi puuttuu pilkku.

Tärkeää viestiä, mikä on issuen ja mikä tekstikommentoinnin rooli. Voi ihan hyvin olla, että ensin kommentoi jotain tekstiin ja jos osoittautuu, että kyseessä ei ole vain triviaali pieni parannus, vaan joku asia, joka herättää enemmänkin keskustelua, niin avaa sitten siitä issuen.

Viimeisessä kohdassa "valmiin version" julkaisu Githubissa kannattaa sopia vähän tarkemmin, mitä tarkoitetaan valmiilla. Voisi olla niin, että aika-ajoin drive kommentointiversiosta "putsataan" etabloituneet muutokset siirtämällä ne Githubiin ja julkaisemalla uusi versio numero, ks. #32

Passiivimuoto: tehdään... ryhmä keskustelee vähän haastava, voisi olla ainakin muutaman nimetyn prosessin fasilitaattorin joukko ja sitten sopimus, että esim. ne livetapaamiset (myös etäosallistuminen mahdollista) ovat niitä keskustelun ja pätöksenteon paikkoja, joihin kannattaa sitten osallistua tai antaa ainakin näkemyksensä etukäteen hyvin tietoon, jos haluaa vaikuttaa.

Tämän voi sitten julkaista täällä githubissa wikisivuna.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants