search

suomi / potilastietojarjestelma

55 stars 7 forks source link

Loppukäyttäjien dokumentaatio #18

Open TomiToivio opened 11 years ago

TomiToivio commented 11 years ago

Ilmoittaudun vapaaehtoiseksi avustamaan loppukäyttäjien käyttöohjeiden laatimisessa. Alustaksi suosittelen vähemmän yllättävästi FLOSS Manualsia: http://fi.flossmanuals.net/

Eräs lähes kaikkien avoimen lähdekoodin projektien suurimmista heikkouksista on juuri se, että loppukäyttäjien dokumentaatioon ja kouluttamiseen ei kiinnitetä kovinkaan paljon huomiota. Tämä projekti voi alusta asti tehdä asiat toisin.

Ilmeisesti eräs kilpailevan hankkeen kalleuden syy on juuri loppukäyttäjien kouluttaminen. Tehdään kerrankin avoimen lähdekoodin järjestelmälle kunnon loppukäyttäjädokumentaatio alusta asti. Ja lisäksi nollabudjetilla tai ainakin Apottiin verrattuna mikroskooppisella budjetilla.

jessesoininen commented 11 years ago

Mitä jos otataan yhdeksi opetusmetodiksi lyhyet videopätkät jotka on läsnä suoraan myös tulevan järjestelmän käyttöliittymässä.

Oppimiseen ja opettamiseen voisi soveltaa modernia "Flipped Classroom" metodia jossa (yhtenä esimekkinä) oppijat katsovat ensin tietyn asiakokonaisuuden videot omalla ajallaan ja sen jälkeen kokoonnutaan ryhmänä yhteen tekemään käytännön simulaatioita kustakin käyttötilanteesta.

TomiToivio commented 11 years ago

Yksi mielestäni tärkeä dokumentaatiomenetelmä olisi ottaa käyttöön Stack Overflow-tyylinen kysymys/vastaus-palsta. Avoimella lähdekoodilla on tarjolla ainakin tämä: http://shapado.com/

Käytännössä erilaisia kysymyksiä tulee niin paljon, että on ihan mahdotonta kirjoittaa kaikki vastaukset dokumentaatioon. Kysymys ja vastaus -palsta on kenties paljon järkevämpi toimintamalli kuin esimerkiksi jokaisen käyttäjän kysymyksiin vastaaminen erikseen.