{"id":229837,"date":"2022-11-11T10:41:00","date_gmt":"2022-11-11T07:41:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229837"},"modified":"2022-11-09T16:35:58","modified_gmt":"2022-11-09T13:35:58","slug":"kuinka-kaeyttaeae-github-pr-malleja","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fi\/kuinka-kaeyttaeae-github-pr-malleja\/","title":{"rendered":"Kuinka k\u00e4ytt\u00e4\u00e4 GitHub PR-malleja"},"content":{"rendered":"\n<p>Jos teet jotain ty\u00f6t\u00e4 \u2013 riippumatta siit\u00e4 onko se avoimen l\u00e4hdekoodin vai suljettu l\u00e4hdekoodi \u2013 (vaikka tied\u00e4n, ett\u00e4 useimmat t\u00e4m\u00e4n sivuston lukijat ovat mukana avoimessa l\u00e4hdekoodissa), k\u00e4yt\u00e4t todenn\u00e4k\u00f6isesti l\u00e4hdekoodia, ja se on luultavasti GitHub.<\/p>\n<p>Monet teist\u00e4 joko seuraatte projektia, osallistutte projektiin tai k\u00e4sittelette projektin vetopyynt\u00f6j\u00e4. Ent\u00e4 ne projektit, joiden parissa ty\u00f6skentelet tiimin kanssa?<\/p>\n<p>Ehk\u00e4 ty\u00f6nkulkusi on jotain t\u00e4llaista:<\/p>\n<ul>\n<li>luot haaran ominaisuuden k\u00e4sittelemiseksi,<\/li>\n<li>ty\u00f6nn\u00e4t haaraa yksityiskohtaisesti ty\u00f6st\u00e4si vertaisarvioitavaksi,<\/li>\n<li>arvostelu on yhdistetty,<\/li>\n<li>sin\u00e4 jatkat.<\/li>\n<\/ul>\n<p>Mutta mit\u00e4 laitat vetopyynn\u00f6n malliin? Onko se sama joka kerta vai onko se erilainen? Ent\u00e4 jos PR:n sis\u00e4lt\u00f6 liittyy johonkin <a href=\"https:\/\/trello.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Trellossa<\/a>, <a href=\"https:\/\/asana.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Asanassa<\/a>, <a href=\"https:\/\/basecamp.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Basecampissa<\/a> tai muussa projektinhallintaj\u00e4rjestelm\u00e4ss\u00e4?<\/p>\n<p>Siell\u00e4 GitHubin PR-mallit tulevat peliin.<\/p>\n<h2>GitHub PR-mallit<\/h2>\n<p>Voit lukea niist\u00e4 kaikki sivulla, mutta t\u00e4ss\u00e4 on ydin (ei sanailua):<\/p>\n<blockquote>\n<p>On vaikea ratkaista ongelmaa, kun t\u00e4rkeit\u00e4 yksityiskohtia puuttuu. Nyt projektien yll\u00e4pit\u00e4j\u00e4t voivat lis\u00e4t\u00e4 projekteihin malleja ongelmia ja vetopyynt\u00f6j\u00e4 varten, mik\u00e4 auttaa avustajia jakamaan oikeat tiedot s\u00e4ikeen alussa<\/p>\n<\/blockquote>\n<p>Ja idea on yksinkertainen: Luomme malleja ongelmille ja ved\u00e4mme pyynt\u00f6j\u00e4 muille, jotka tarjoavat tietyn tason tietoja, jotka heid\u00e4n on t\u00e4ytett\u00e4v\u00e4 ennen ongelman tai vetopyynn\u00f6n l\u00e4hett\u00e4mist\u00e4.<\/p>\n<p>T\u00e4m\u00e4 auttaa meit\u00e4 yll\u00e4pit\u00e4jin\u00e4 tiet\u00e4m\u00e4\u00e4n, mit\u00e4 tietoja tarvitsemme ennen niiden tutkimista. Lis\u00e4ksi se voi antaa meille mahdollisuuden linkitt\u00e4\u00e4 aikaisempaan numeroon, aikaisempaan lippuun tai ennen kaikkea projektiin liittyv\u00e4\u00e4n.<\/p>\n<p>Esimerkkin\u00e4, oletetaan, ett\u00e4 ty\u00f6skentelet projektin parissa ja haluat sis\u00e4llytt\u00e4\u00e4 siihen seuraavat tiedot:<\/p>\n<ul>\n<li>lyhyt kuvaus PR:n toiminnasta, jotta yll\u00e4pit\u00e4j\u00e4n ei tarvitse arvailla,<\/li>\n<li>PR:n tila siit\u00e4, pit\u00e4isik\u00f6 sen olla valmis yhdistett\u00e4v\u00e4ksi vai onko se viel\u00e4 kehitteill\u00e4, mutta valmis tarkistettavaksi,<\/li>\n<li>linkki lippuun projektip\u00e4\u00e4llikk\u00f6ss\u00e4si, johon PR on merkityksellinen.<\/li>\n<\/ul>\n<p>En v\u00e4it\u00e4, ett\u00e4 t\u00e4m\u00e4 on vaadittu tieto, mutta olemme k\u00e4ytt\u00e4neet niit\u00e4 ja olen todennut hy\u00f6dyllisiksi (ja on mukava n\u00e4hd\u00e4, ett\u00e4 <a href=\"https:\/\/help.github.com\/articles\/helping-people-contribute-to-your-project\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">ajan my\u00f6t\u00e4<\/a> on tehty lis\u00e4\u00e4 parannuksia ).<\/p>\n<h3>Mutta kuinka k\u00e4yt\u00e4mme t\u00e4t\u00e4?<\/h3>\n<p>Sivusto on melko selke\u00e4, mutta se on todella yksinkertainen. Tarvitset seuraavat tiedostot projektisi hakemistoon tai projektisi hakemistoon. <strong>github-<\/strong> hakemisto:<\/p>\n<ul>\n<li><strong>ISSUE_MALLINE<\/strong><\/li>\n<li><strong>PULL_REQUEST_MALLINE<\/strong><\/li>\n<\/ul>\n<p>Kaikkien n\u00e4iden pit\u00e4isi olla merkint\u00e4tiedostoja, jotka paljastavat tarkalleen, mit\u00e4 etsit avustajiasi sis\u00e4llytett\u00e4v\u00e4ksi aina, kun he osallistuvat projektiisi jollain tavalla.<\/p>\n<p>Ja sitten aina, kun k\u00e4ytt\u00e4j\u00e4 haluaa ilmoittaa ongelmasta tai luoda vetopyynn\u00f6n, h\u00e4n on kehottanut k\u00e4ytt\u00e4m\u00e4\u00e4n mallin tietoja.<\/p>\n<p>Hienoa, eik\u00f6?<\/p>\n<h2>Se ei ole paljon, mutta\u2026<\/h2>\n<p>Et ehk\u00e4 ajattele, ett\u00e4 se on paljon, mutta on melko helppoa auttaa parantamaan projektiin tulevan tiedon laatua, pyyt\u00e4\u00e4 osallistujia miettim\u00e4\u00e4n, mit\u00e4 he laittavat projektiin, ja sitten reagoida vastaavasti.<\/p>\n<p>Lis\u00e4ksi se auttaa sinua ja muuta tiimi\u00e4si ymm\u00e4rt\u00e4m\u00e4\u00e4n, mit\u00e4 tarkistetaan, ja valmistautua kaikkiin muutoksiin, joita saattaa tulla heid\u00e4n tielleen ty\u00f6skennelless\u00e4\u00e4n n\u00e4iden projektien parissa.<\/p>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/tommcfarlin.com\" class=\"external external_icon\">tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Ent\u00e4 jos PR:n sis\u00e4lt\u00f6 liittyy johonkin Trellossa, Asanassa, Basecampissa tai muussa j\u00e4rjestelm\u00e4ss\u00e4? Siell\u00e4 GitHubin PR-mallit tulevat peliin.<\/p>\n","protected":false},"author":1,"featured_media":165951,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[1018,719,843],"tags":[1166],"class_list":["post-229837","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-hyodyllisia-sivustoja","category-kehittaejae","category-opetusohjelmia","tag-affiai-fi"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/229837","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/comments?post=229837"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/229837\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media\/165951"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media?parent=229837"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/categories?post=229837"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/tags?post=229837"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}