Leiðarvísir frá Naglasúpunni
Hvernig leggur þú hugbúnaðarverkefni lið?
Byrjaðu á að skilja verkefnið og spyrja hvað myndi hjálpa. Komið ykkur saman um eitt lítið framlag, fylgdu leiðbeiningum höfundarins og skildu eftir nægt samhengi til að hægt sé að yfirfara verkið. Framlag getur falist í prófunum, skrifum, hönnun eða kóða.
Uppfært
Veldu verkefni sem þú getur skilið og notað
Skoðaðu verkefnin á Naglasúpunni og veldu eitt sem fæst við vanda sem vekur áhuga þinn. Prófaðu aðalferlið eða lestu leiðbeiningarnar áður en þú stingur upp á breytingum. Þá tengist boð þitt raunverulegum þörfum verkefnisins.
Leitaðu í tenglum höfundarins að leiðbeiningum um framlög og opnum verkum. Opinber verkefnasíða er ekki sjálfkrafa boð um að breyta kóðanum og segir ekki til um hvort opið hugbúnaðarleyfi gildi. Ef engar leiðbeiningar eru til staðar skaltu spyrja stuttrar spurningar í umræðu verkefnisins.
Gátlistinn fyrir fyrsta framlag hjálpar þér að velja verk og undirbúa gagnleg skil.
Hverju getur þú lagt lið öðru en kóða?
Gagnlegt framlag fjarlægir tiltekna hindrun fyrir fólk sem smíðar eða notar verkefnið. Það gæti verið að skrá uppsetningarskref, endurtaka villu, útskýra óljóst hugtak, prófa útlit í síma eða yfirfara íslenska þýðingu. Spyrðu hvort óskað sé eftir verkinu áður en þú byrjar á stórri endurskoðun.
Open Source Guides frá GitHub lýsa ýmsum leiðum til þátttöku og hvernig má nálgast verkefni. Leiðbeiningar verkefnisins sjálfs ráða því hvar á að skila framlagi og hvernig yfirferð fer fram. Ráðin hér eiga einnig við samstarf þar sem kóðinn er ekki opinber.
Semjið um verkið og yfirferðina
Áður en þú byrjar skaltu staðfesta niðurstöðuna sem stefnt er að, hver muni yfirfara hana og hversu miklum tíma þú getur varið. „Prófa skráningarferlið á litlum skjá og senda merktar skjámyndir“ er auðveldara að meta en „Bæta notendaupplifunina“.
Láttu snemma vita ef aðgangur eða tæknileg ákvörðun hindrar þig. Lítið framlag þarf skýran endapunkt: skýrslu skilað, texta yfirfarinn eða breytingu prófaða. Að klára eitt lítið verk gefur báðum aðilum grunn til að ákveða hvort þeir vilji halda áfram.
Ef þú ert höfundurinn sem óskar eftir hjálp skaltu nota sniðið fyrir samstarfsbeiðni til að gera væntingarnar sýnilegar.
Gerðu verkið auðvelt í yfirferð
Lýstu því sem breyttist, hvers vegna og hvernig þú kannaðir það. Láttu skjámyndir fylgja sjónrænum atriðum og skref til að endurtaka villur. Haltu ótengdum hugmyndum til hliðar svo hægt sé að meta eitt verk í einu.
Segðu opinskátt frá því sem er óklárað og ákvörðunum sem þú þarft hjálp við. Framlag er boð um verk til yfirferðar; höfundurinn getur óskað eftir breytingum eða valið aðra leið. Þegar verkið er samþykkt skaltu semja um hvernig framlagsins verði getið og skrá það sem næsti þátttakandi þarf að vita. Slíkar leiðbeiningar auðvelda næsta manni fyrsta skrefið.
Nánar um efnið
Gátlisti fyrir fyrsta framlag þitt til hugbúnaðarverkefnis
Veldu lítið framlag, lestu leiðbeiningar verkefnisins, semdu um umfangið og skilaðu verki sem umsjónaraðili getur yfirfarið.
Hvernig finnur þú samstarfsfólk fyrir hliðarverkefni?
Skrifaðu skýra samstarfsbeiðni sem lýsir hliðarverkefninu, aðstoðinni sem þú þarft, tímaskuldbindingu og fyrsta verkinu.
Viltu benda á leiðréttingu eða gagnlegt dæmi? Hafðu samband.