Kalo te përmbajtja
Nis një projekt

Çfarë i duhet një projekti me kod të hapur nga faqja

Mësime nga faqet për AntennaPod, K-9 Mail, AnySoftKeyboard dhe projekte të tjera që mbahen nga vullnetarë.

Publikuar
Koha e leximit
4 min
Seri
Nën kapakPjesa 6 nga 10
Përmbajtja7
  1. Dy audienca në të njëjtën faqe
  2. Shpjegojeni produktin me fjalët e lexuesit
  3. Bëjeni faqen të lehtë për t’u mirëmbajtur nga vullnetarët
  4. Planifikoni kapitullin e radhës të projektit
  5. Mjetet e vogla mund të bëjnë shumë punë
  6. Komunitetet kanë nevojë për rrugë, jo vetëm për faqe
  7. Nëse drejtoni një projekt

Kemi ndërtuar dhe ridizajnuar faqe për disa projekte me kod të hapur: luajtësin e podcast-eve AntennaPod, klientin e email-it K-9 Mail, tastierën AnySoftKeyboard, bllokuesin e reklamave AdAway, menaxherin e fjalëkalimeve Passman dhe komunitetin Open Source Design. Produktet janë shumë të ndryshme. Pyetjet pas çdo faqeje ishin çuditërisht të ngjashme.

Dy audienca në të njëjtën faqe

Faqja e një kompanie zakonisht u flet klientëve. Një projekt me kod të hapur u flet të paktën dy grupeve: njerëzve që duan ta përdorin softuerin dhe njerëzve që mund të ndihmojnë ta ndërtojnë.

Te AntennaPod ridizajnuam faqet e veçorive dhe rrugët drejt çdo shkarkimi, pastaj u dhamë komunitetit, dokumentacionit dhe blogut të projektit lidhjet e tyre të qarta. Dëgjuesit gjejnë aplikacionin. Kontribuesit gjejnë forumin dhe projektin në GitHub pa kërkuar nëpër faqe të menduara për dëgjuesit.

AnySoftKeyboard kishte të njëjtën ndarje. Faqja prezanton veçori si shkrimi me gjeste, temat dhe modaliteti inkognito, rendit gjuhët e mbështetura dhe pastaj u tregon kontribuesve të rinj ku të nisin me kodin dhe përkthimet.

Një test i dobishëm: a mund ta kuptojë një vizitor i ri brenda pak sekondash nëse faqja është për të dhe ku shkon klikimi i radhës?

Shpjegojeni produktin me fjalët e lexuesit

Softueri me kod të hapur shpesh përshkruhet nga ata që e ndërtojnë, me gjuhën që përdorin mes tyre. Kjo funksionon në faqen e depos së kodit. Jo gjithmonë funksionon për dikë që po vendos nëse do ta instalojë aplikacionin.

Passman është menaxher fjalëkalimesh që instalohet në serverin tuaj. Prandaj faqja duhej të shpjegonte vetë-hostimin, enkriptimin dhe instalimin për njerëz që ndoshta nuk kanë server të tyrin. E mbajtëm gjuhën të thjeshtë dhe i grupuam në të njëjtën faqe instalimin, aplikacionin celular, shtesat për shfletuesin dhe mënyrat për të kontribuar. Lexuesit teknikë i gjejnë detajet. Të tjerët nuk ndalen prej tyre.

Bëjeni faqen të lehtë për t’u mirëmbajtur nga vullnetarët

Shumë projekte nuk kanë njeri që merret vetëm me faqen. Kush e përditëson, mund ta bëjë një herë në muaj, mes kontributeve të tjera.

Kjo është një nga arsyet pse shumica e këtyre faqeve janë statike. AnySoftKeyboard dhe K-9 Mail funksionojnë me Jekyll; Open Source Design është ndërtuar me Hugo dhe publikohet përmes GitHub Pages. Nuk ka hyrje në CMS për t’u mbrojtur dhe as bazë të dhënash për t’u përditësuar. Një ndryshim në faqe kalon nga i njëjti shqyrtim si një ndryshim në kod: dikush hap një pull request, dikush tjetër e kontrollon dhe faqja rindërtohet.

Qasjen e përgjithshme e shpjegojmë te pse ndërtojmë faqe me Hugo. Për projektet me vullnetarë, përfitimi kryesor nuk është shpejtësia. Është fakti që kontribuesit mund të rregullojnë një gabim shkrimi ose të shtojnë shënimet e një versioni të ri me mjetet që përdorin tashmë.

Planifikoni kapitullin e radhës të projektit

Projektet me kod të hapur ndryshojnë emër, bashkohen me projekte të tjera dhe zhvendosen. K-9 Mail u bë baza e Thunderbird për Android. Faqja duhej t’i mbante të disponueshme informacionin për veçoritë dhe lajmet e projektit, ndërsa i dërgonte vizitorët te Thunderbird për Android për përditësimet e reja, pa ngatërruar ata që e njihnin me emrin e vjetër.

Faqja e një projekti duhet të jetë në gjendje të thotë qartë “kjo është zhvendosur”. Kjo do të thotë adresa të qëndrueshme për faqet e vjetra, një njoftim i dukshëm aty ku duhet dhe asnjë lidhje shkarkimi që nuk funksionon.

Mjetet e vogla mund të bëjnë shumë punë

Jo gjithçka në faqen e një projekti është tekst. Për AdAway, krahas faqes së rifreskuar, e rikrijuam logon si SVG të pastër dhe shtuam një mjet në shfletues për konvertimin e skedarëve hosts. Një mjet i fokusuar si ky shpesh i përgjigjet një pyetjeje për të cilën dokumentacioni do të kishte nevojë për disa paragrafë.

Komunitetet kanë nevojë për rrugë, jo vetëm për faqe

Open Source Design lidh dizajnerët me projekte me kod të hapur. Faqja duhet t’u shërbejë dizajnerëve që kërkojnë punë, projekteve që publikojnë pozicione dhe anëtarëve që marrin pjesë në aktivitete dhe diskutime. Punët e hapura, aktivitetet e ardhshme, forumi dhe burimet i bëmë të arritshme nga faqja kryesore, ndërsa pjesën tjetër e organizuam sipas asaj që vizitorët kërkojnë të bëjnë.

Nëse drejtoni një projekt

Para një ridizajnimi ndihmon të shkruani:

  • kush e përdor softuerin dhe kush kontribuon në të
  • çdo vend ku njerëzit mund ta shkarkojnë ose ta instalojnë
  • ku ndodhen dokumentacioni për kontribuesit, përkthimet dhe diskutimet
  • kush do ta mirëmbajë faqen dhe si shqyrtohen ndryshimet

Këto projekte i gjeni në portfolion tonë. Nëse projekti juaj ka nevojë për një faqe të re ose për rifreskimin e një të vjetre, na kontaktoni.

Hapi tjetër

Po planifikoni një faqe? Na tregoni çfarë ju duhet dhe ju kthejmë një plan dhe një çmim të qartë.