Redizajniranje Nodejs.org: 1. dio

Konkurentska studija slučaja

Web stranica Node.js nije imala značajno ažuriranje sadržaja i informacijske arhitekture (IA) od početka 2014. godine, a puno se toga promijenilo od tada! Trendovi dizajna su se pomakli, konkurentni krajolik postao je gužvi, a projekt Node postigao je nove visine u zajednici programera. Svijet radi na čvoru i vjerujem da bi uvjet njegove javne slike trebao odgovarati kvaliteti koda.

Svijet teče čvorom

Da bih pomogao pokretanju brainstorm web stranice Node.js u Github Repo, pogledao sam deset najvećih web lokacija platforme za programere i sintetizirao neke od mojih najdražih IA izbora, elemenata dizajna i mogućnosti interakcije na popis preporuka za nadolazeći redizajn web stranice Node.js.

Napomena: Znam da sam propustio obilje nevjerojatnih značajki vani - ovaj članak nikako nije iscrpan! Prokomentirajte pri dnu svoja omiljena iskustva s razvojnim programerima sa cijelog weba.

Država web mjesta razvojnih programera

Što se događa s izvrsnom web stranicom za dokumentaciju za razvojne programere? Jezik programiranja i okviri okvira sučeljavaju se s finom linijom - one moraju biti ujedno i pozivnice pridošlicama, a istovremeno biti vrijedan resurs za napredne korisnike.

Kada sam prvi put započeo s tim postupkom, planirao sam zadržati ovaj pregled isključivo na programskim web lokacijama, ali ubrzo sam otkrio da su te stranice prilično ... dobro ... dosadne.

Ispada da okviri frontenda dominiraju na tržištu uzbudljivih i inovativnih dizajnerskih stranica. Vjerujem da je to iz dva razloga:

  1. Ove web stranice izrađuju web programeri, za web programere, na platformi za koju su dizajnirani i;
  2. Intenzivna konkurencija u okviru okvira frontenda prisiljava ove projekte da se agresivno bore za udio na tržištu i neprestano poboljšavaju svoje marketinške i teretničke napore.

Prihvativši ovaj uvid pri kraju, pregledao sam deset (10) web mjesta programskog jezika i okvira Frontend koja vode njihove prostore kako bih prikupio ideje za ovaj članak. To su određeni redoslijed: Scala, Rust, Dart, Ember, React, Angular, Vue.js, Go, Swift i Ruby.

Ako ste toliko skloni, ovdje možete pronaći bilješke mog toka svijesti, uglavnom nerevidirane, na ovih deset web lokacija za razvojnu dokumentaciju:

Estetika

Izgled web stranice mora predstavljati načela i vrijednosti projekta. Srećom po nas, na Node Interactive 2017 u Vancouveru, suradnička zajednica izvela je vježbu koja će vam pomoći prepoznati neke od Node.js osnovnih vrijednosti. Ovo je bila prva prva od mnogih radionica Node.js Core Values, ali nam je pružila divnu odskočnu dasku za pokretanje redizajna:

Node.js temeljne vrijednosti
Čvor je: stabilan, inkluzivan, dobrodošao, uspješan i zabavan

Uporedimo ove koncepte s trenutnim dizajnom web mjesta:

Nodejs.org Circa 2017

✘ Dobrodošli: Veliki sivi blokovi otvaraju prikazni prostor, sužavaju sadržaj i šalju neodgovarajuću poruku.

Lusive Uključno: Zelena na tamno sivoj boji ne djeluje dobro za članove koji slijepe u boji. Hladno pisanje dobiva poruku preko, ali ne mnogo drugo.

✘ Stabilan / izvedljiv: nespretni izgled, neobična tipografija i nedostatak vertikalnog ritma ne vrište na profesionalizam.

✘ Zabava:… Obožavam korporativne sive!

Misli za poboljšanje:

  1. Osvijetliti! Dominantna boja u ovom dizajnu je tamno siva. Dobro je, to može izgledati profesionalno, ali rijetko se opisuje kao "gostoljubivo". Proširenje palete boja na svjetlo sive boje koje pohvaljuju boju marke (ili čak * dah * druga boja ?!) povećaće ekspresivnost web mjesta i pružiti više opcija dizajnerima ..
  2. Odaberite stil ilustracije ili fotografije: Malo slika prelazi dug put za humanizaciju web mjesta. Ovo će pomoći posjetiteljima da se osjećaju dobrodošlim i oslikavaju web mjesto kao prijateljsko, privlačno i korisno mjesto za istraživanje.
  3. Tipografska hijerarhija / vertikalni ritam: Imajući dobro definiranu hijerarhiju i ritam sadržaja, zbližava dizajn i vrišti „stabilno i profesionalno“ kao ništa drugo. Ovaj dodatni sloj laka pobudit će samopouzdanje
  4. Igrajte se s oblicima: Logotip čvora lijepo je geometrijski. Pomoću ovog dizajna možete nadahnuti nove, zanimljive i dinamične rasporede i vizualne elemente koji zrcale logotip. Ovo će pomoći da se web-lokacija osjeća tržišno zaštićenom i dodati malo iskre zabave u nekretninu.
  5. Pronađite svoj glas: ton je važan. Kad korisnici stignu na NodeJS.org, oni su tu da nauče nešto. Oni ulaze u čudno, strano mjesto u potencijalno ranjivom, "trebam li uopće biti ovdje", stanje uma - važno je razgovarati s njima kao s prijateljem! Najučinkovitija mjesta dokumentacije na koja sam naišla uspostavljaju osjetljivu ravnotežu između suhog, tehničkog sadržaja i ležernog, razgovornog izlaganja.

navigacija

Navigacija sidri posjetitelje na vašoj web lokaciji i pruža smjernice kako se ne bi izgubili ili preplavili. Web lokacije za dokumentaciju imaju svojstven sadržaj. Posao navigacije je održati ovo organizirano i ne zastrašujuće.

TL; DR: Jednostavno uklonite zastrašivanje zečje rupe koju ćete uskoro baciti

Evo dobrog pravila: korisniku predstavite samo između četiri i šest glavnih navigacijskih stavki ili riskirate zbog brige zbog izbora.

Žao mi je Vue.js, vaše ogromne padaonice zaista su zastrašujuće!

Umjesto toga, vodite korisnika gdje želi ići, predstavljajući male izbore veličine zalogaja na putu.

Da bi se to postiglo, mnoge web stranice predstavljaju sekundarni navigacijski ili unutarnji izbornik harmonike.

Scala Secondary Nav

Ova potreba za jednostavnošću ne znači da se ne možemo malo zabaviti s navikom! React naglašava najnoviju verziju izdanja u svom nav, u svakom trenutku, a Go vam omogućuje otvaranje uređivača i igranje s kôdom s bilo kojeg mjesta na web lokaciji s dokumentacijom.

Sveprisutni broj verzije na vrhu Reactjs.orgMožete otvoriti urednik za igranje s bilo kojeg mjesta na web lokaciji Go docs!

Najbolji način da utvrdimo pripada li neki predmet u navi je postaviti sebi ovo pitanje:

Što ovdje korisnici rade 90% vremena koje posjećuju?

Odgovarajući na ovo pitanje, lako možemo održati prolaznu navigu i smanjiti anksioznost kod izbora za novopridošle osobe na Nodejs.org.

Imajući sve to u vidu, sada možemo dati nekoliko preporuka za web stranicu Node.js. Trenutno Node nudi osam mogućnosti korisnicima u glavnoj navigaciji. Preporučam da ovo smanjimo na šest:

Početna | Saznajte | Dokumenti | Priopćenja | Zajednica | Blog

Velika većina postojećeg sadržaja uklapa se u ovih šest stranica. Međutim, postoji nekoliko važnih stranica koje se ne uklapaju u ovu nav strukturu. Na primjer: upravljanje, sigurnost, pravni, imovina marke, itd.

Ove stranice ne zadovoljavaju naše kriterije korištenja od 90%, pa nisu iz glavne navigacije. Srećom, imamo često zaboravljeno mjesto za iskrcati ove vrlo zaslužne stranice: podnožje stranice! Prečesto se podnožje zaboravlja kao vrijedno mjesto za spremanje navigacije koje je važno da bi se korisnici lako pronašli bez dodavanja kognitivnih troškova za većinu posjetitelja.

Dakle, pogledajmo ovih šest glavnih odjeljaka jedan po jedan, zar ne?

Početna stranica

Početna stranica web stranica za dokumentaciju za programere pretrpjela je stalni pomak u posljednjem desetljeću. Ono što je nekad bilo suho iznošenje činjenica, razvilo se u visoko fokusirani marketinški i društveni apeli. Ugodni i inkluzivni tonovi ovih brandova izgledali su kao da govore: "možete obaviti posao i zabaviti se dok to radite!"

Ovaj prelazak na aktivni marketing očigledniji je u daleko konkurentnijem okvirnom prostoru JavaScripta, ali također se može vidjeti kako propada na web-mjesta programskog jezika. Ovi projekti koče tanku granicu između profesionalne ćudljivosti i diletantske nezrelosti, ali čini se da uvijek pada na onu stranu koja je na radnom mjestu prikladna - tešku iglu za nabijanje.

Stranice za marketing, naravno, uvijek počinju s nečim što bi trebalo izgledati vrlo poznato kod nas iskusnih web navigatora: Hero Banner.

Podebljani marketinški natpisi s 1 ili 2 primarna CTA-a - izgledaju poznato?

Ovu komponentu često prati drugi poznati marketinški obrazac: „Jedan-dvije-tri prodajne ponude“ (naziv je u tijeku).

Odgovara na pitanje:

Također je vrlo često da web mjesta imaju istaknut „oglasnu jedinicu“ prostora za prodaju nadolazećih događaja i konferencija koje su domaćini.

Dinamične oglasne jedinice za konferencije i događaje

Neki od najdražih iskustava na ovim stranicama s dokumentacijom su primjeri kodova uživo. Omogućuju korisnicima da brzo umaraju ruke, bez ijednog napora, što u velikoj mjeri smanjuje troškove kupovine.

Primjeri šifri uživo svi su bijes

Početna stranica također je mjesto hvalisanja vaših sponzora i glavnih potrošača - ja to nazivam „Apel to Pitch Pitch“.

Pojedinosti o sponzorstvu / glavnom korisniku

Nemojte me krivo shvatiti, ove web stranice nisu sve izgled kolačića - tu je i novost koja se odnosi na komponente početne stranice za razvojne programere:

Pikado “Označeni obilazak” - kliknite na podcrtani odjeljak da biste saznali više o jezikuOdjeljak Forumi za komunikaciju zajednice na scala-lang.orgEmber Job Board Up-sell

Ako želimo nadahnuti našu inspiraciju za dizajn početne stranice, možemo pogledati najnovije i najveće samopromatore - web mjesta koja su osvojila nagrade Webby u kategorijama kao što su "Profesionalne usluge", "Financijske usluge / bankarstvo" i "Web usluge / aplikacije" - kako biste vidjeli najveće trendove u dizajnu stranica splash:

U 2017. godini postojao je trend prema odvažnim, kinetičkim, cjelovitim marketinškim iskustvima. Možda će nam biti od koristi posuditi trendove dizajna s krvavih ruba poput ovih krećući se prema naprijed.

Naučiti

Skoro svaka pregledana web lokacija ima povremeni, razgovorni ton, vodič za početak rada s okvirom ili jezikom. Sadržaj koji je ovdje predstavljen spušta prepreku ulasku na platformu, omogućavajući zajednici da ispuni „uključivi“ i „dobrodošli“ kulturni mandat.

Čitav ovaj odjeljak vidljivo nedostaje na web stranici Nodejs.org! Pomalo je pokrivena duboko skrivenom stranicom vodiča, ali ne i standardom koji se očekuje od modernih web stranica s dokumentacijom.

Mnogi odjeljci "Prvi koraci" poprimaju vrlo sličan format: duga listanja stranica koje čitaju poput niza povremenih postova na blogovima, podijeljena u dobro komunicirane lekcije koje slijede dobro definirani put učenja. Na kraju cijelog postupka vi ste stručnjak za taj proizvod! Pa, možda nije stručnjak, ali barem znate dovoljno da bude opasno.

Ovi planovi lekcija često su vizualizirani s dugim izbornicima sekundarnih harmonika poput ovih:

Da, ovaj je izbornik bio posvuda!

Ovi sekundarni izbornici vrlo su prikladni za vizualizaciju „staza učenja.“ Omogućuju korisniku da vidi cjelokupni plan lekcije, pripreme se za sljedeće što slijedi i raduju se njihovom postignuću nakon što dođu do cilja.

Međutim, uzimanjem lekcija iz drugih proizvoda čiji je posao edukacija, možda ćemo moći poboljšati na našoj budućoj stranici „Početak rada“. Ovi sekundarni izbornici podsjećaju na slične značajke u alatima za učenje kao što su LinkedIn Learning, Khan Academy, pa čak i na popisima za reprodukciju videozapisa na YouTubeu. Ako izvadimo izdanje iz njihovih knjiga, možemo pomoći našim najnovijim članovima da nauče još više.

Neke stranice s dokumentacijom pokušavaju prenijeti te lekcije na drugu razinu. Konkretno, „Go Tour” pruža interaktivnu lekciju kako bi naučio svoje korisnike kako kodirati na Go. Ovaj se format često koristi na platformama za samostalno učenje poput CodeAcademy i FreeCodeCamp.

Vjerujem da hibridni format može biti učinkovit - prikazati sekundarni izbornik "staze za učenje", s neobaveznim vježbama u svakom odjeljku za korisnike koji traže iskustvo poput tutorijala.

Bez obzira na prezentaciju, odjeljak Za početak je potrebno imati svako moderno mjesto s dokumentacijom.

Dokumentacija

Za razliku od odjeljka "Učenje", u odjeljku dokumentacije sve je o sirovim podacima o API-ju. To su dolje i prljave informacije niske razine kojima korisnici energije žele brzi pristup.

Međutim, to što su korisnici energije, to ne znači da iskustvo pregledavanja API-ja ne može biti ugodno! Najbolji API-ji učionice brzo se kreću - ne može se desiti previše klikova da bi se pronašla metoda koju tražite ili drugo ... Ups! Tvoj laptop ide kroz prozor.

Dva najveća prekršitelja teško pristupačne dokumentacije API-ja su Rust i Angular. Za kretanje po dokumentima gotovo je potreban gumb za povratak. Zapamtite: klikovi su skupi, pomicanje je jeftino, a bočni izbornici su vaš prijatelj.

Sjajni API dokumenti ne samo da dobro pregledavaju, već i čitaju dobro. To što je ovo "suh" odjeljak vaše web stranice ne znači da mora biti dosadno!

API-vodiči lako se kreću na običnom engleskom jeziku - čak i napredni vodiči mogu čitati kao razgovor s korisnikom.

Dokumentacija verzija je posebno važna u brzom JavaScript ekosistemu. S novom velikom verzijom koja se objavljuje svakih šest mjeseci, Node je u relativno brzom ciklusu izdanja u usporedbi s ostalim programskim jezicima. Zbog toga i tendencije da se različite prirode Node aktivno koriste u divljini, izuzetno je važno da korisnici mogu brzo i lako prelaziti s inačice na API dokumentaciju.

Web-lokacija čvora trenutno pruža popis svih verzija dokumentacije u prošlosti, ali jednom kada se nalazi web mjesto API dokumenata, ne postoji način da se lako prebaci na drugu verziju. Mnogi će korisnici izravno doći do dokumentacije API-ja putem google pretraživanja ili veze Stack Overflow i možda će trebati način da se verzije prebace pravo na stranicu. Padajuće verzije standardni su način da se to postigne:

Nažalost,

Sadržaj Node.js API dokumentacije dobro je napisan, iscrpan i informativan. Međutim, prezentacija ostavlja nešto što bi moglo poželjeti i mogla bi upotrijebiti dobar dizajn. U dokumentaciji nedostaje opsežni odjeljak o arhitekturi. Također može biti korisno podijeliti C ++ Addon i N-API dokumentaciju u svoj vlastiti odjeljak.

javnost

Odjeljak za izdanja često se na drugim web stranicama naziva "Preuzimanja" ili "Instaliraj", a pretpostavljam da će naziv ovog odjeljka biti kontroverzan

Odlučio sam se nasloviti ovaj odjeljak Izlazi iz dva razloga:

  1. CTA za "Install" pojavit će se i na početnoj stranici kao primarni CTA i u hodu "Prvi koraci". Ovo su primarni putevi do instalacije većine novih korisnika.
  2. Pozivanjem ovog odjeljka Priopćenja možemo na jednostavan način pronaći podatke o ciklusima puštanja, procesu i prošlim verzijama. Ovim se čuva hijerarhija informacija na web mjestu i poboljšava otkrivanje drugog važnog sadržaja, a istovremeno predstavlja jednostavan put za otkrivanje korisnicima koji mogu propustiti "Instalirati" CTA-ove drugdje na web mjestu.

Odjeljak za izdanja trebao bi sadržavati ova tri pododjeljka u sekundarnom nav:

  1. Početna: (Instaliraj / pusti informacije o ciklusu)
  2. Sva izdanja
  3. Nightly Builds

Početna stranica izdanja prvo i najvažnije će prikazati widget za instaliranje. Ovaj je widget možda sličan trenutnoj stranici za preuzimanje jednog čvora, ali pojednostavljen je da stane u zaglavlje stranice i pojednostavi postupak instalacije.

Kad ponovno pomislimo na slučaj upotrebe od 90% na ovoj stranici, većina će korisnika tražiti ili Windows Installer, Mac Installer ili Linux Binaries. Izborom da u početku prikažemo samo ove tri mogućnosti - s padajućim izbornikom „Ostale mogućnosti preuzimanja“ koji je lako dostupan za upotrebu slučajeva s dugim repom - smanjujemo veličinu modula i smanjujemo složenost stranice. Klikom na padajući izbornik "Ostale mogućnosti preuzimanja" izložit ćete se svim detaljnim opcijama za preuzimanje koje su trenutno uvijek vidljive za korisnike napajanja.

Pojednostavljujući vidljive mogućnosti instalacije u naš slučaj korištenja od 90%, sada imamo gotovo cijelu stranicu za pružanje vrijednih informacija o postupku izdanja Node.js!

Objašnjavajući postupak i vremensku traku izdanja Node.js u lako razumljivoj terminologiji, pozivamo korisnike na preklop, tako da se osjećaju još bližim dijelom procesa razvoja. To uklanja omotač nenamjerne tajnosti koji je proces izdanja držao na udaljenosti od ruke i potiče emocionalna ulaganja i vlasništvo nad Node.js.

Ništa na tržištu ne objašnjava složenije cikluse oslobađanja od Ember Builds stranice:

Stranica Ember gradi

Kao i web mjesto Ember, vizualizacije procesa izdavanja na nodejs.org mogu biti potaknute NS-ovom Rasporedom izdanja JSON za još zanimljiviji i informativniji doživljaj.

Prelazak na stranicu "Sva izdanja" ili "Nightly Builds" prikazat će popis sličan trenutnoj stranici Prethodna izdanja. Međutim, možda bismo željeli uključiti motornu sklopku za odabir V8 ili ChakraCore i mogućnost odabira / filtriranja ciljeva izrade kako bismo konsolidirali stranice listova. SHA257 Kontrolni zbrojevi mogu se prikazati na ovom popisu kako bi im se svidjela stranica za preuzimanje Go za još veću konsolidaciju stranica s listovima.

Jeste li spremni za ludu, zamišljenu ideju? Kao alternativa instalacijskom widgetu na početnoj stranici Releases, Node bi mogao odabrati održavanje jedinstvene skripte za instalaciju, kao što to čine mnogi drugi projekti:

Skripta za instalaciju hrđe - jedna crta Bash-a

Oslonit ću se na one poznatije CLI-jeve skripte za raspravu o pojedinostima, ali postoje mnogi postojeći projekti koje Node može koristiti kao temelj za skriptu poput ove, a koji će ispuniti većinu slučajeva korištenja.

Zamislite mogu li novi programeri jednostavno pokrenuti:

curl install.nodejs.org | sh

I na njihovim se strojevima instalira najnovije izdanje LTS-a.

Namjera ovdje je smanjiti 90% slučajeva upotrebe instalacije na jednostavnu kopiju i lijepljenje u jednoj liniji.

Instalirani CLI mogao bi biti jednako potpun kao nvm ili jednostavan kao jednokratni instalacijski program Rust. Očito je mnogo tehničkih prepreka za savladavanje takvog alata, a detalje ove značajke bolje bi bilo prepustiti Tehničkom upravnom odboru, ako je to uopće moguće.

Bez obzira na detalje implementacije instalacije, osnovna odgovornost ove stranice ostaje ista: Dopustite instalaciju Node verzija s što manje trenja za 90% korisnika slučaja, istovremeno pružajući izlazni otvor za korisnike koji mogu zahtijevati više specijalizirane podrške ,

Zajednica

Stranice zajednice, po svojoj definiciji, sadrže neke od najvažnijih ljudskih sadržaja na web lokaciji za razvojne programere. Zbog toga je nemoguće pokriti sve mogućnosti za sadržaj i prezentaciju u ovom članku - oni zaslužuju blog blog sve svoje!

Kako je rečeno, u ovom se članku neće temeljiti na posebnim preporukama za izgled. Umjesto toga, predstavlja pomalo ideje i strukturu ponude i pomaže potaknuti raspravu dok zajednica započne raspravu. Također, začudo, mora argumentirati postojanje stranice zajednice u navigaciji najviše razine.

Zašto promovirati zajednicu

To je točno, trenutna web stranica Node.js ne sadrži namjensku stranicu zajednice! Postoje dijelovi obloženi srodnim materijalom, ali unatoč temeljnim vrijednostima čvora Inkluzivnost, dobrodošlica i zabava web stranica trenutno ne postavlja zajednicu ispred i središta.

Stranice zajednice na drugim mjestima na ovom prostoru funkcioniraju kao polazišta u veći ekosustav koji se stvorio oko proizvoda. Node ima jedan od najbogatijih ekosustava vani i zločin je ne prikazivati ​​zadivljujuće resurse koje je ova zajednica razvila!

Taksonomija zajednice

Na pregledanim web-lokacijama resursi zajednice uvelike se uklapaju u ovih osam kategorija:

  1. Comms: Forumi, popisi za slanje popisa i chatovi
  2. Poslovi: Resursi za otkrivanje poslova
  3. Konferencije: Konf. Info, prošlost i sadašnjost
  4. Zajednica: Korisničke grupe i sastanci
  5. Vijesti: Službene i neslužbene publikacije / Podcasti
  6. Obrazovanje: Učenjani resursi u zajednici
  7. Alati: Knjižnice i alati treće strane
  8. Suradnja: Upute za dodavanje kodeksa i izvješćivanje o problemima

Pet najboljih primjera pronašao sam robustan sadržaj stranica u zajednici pojavio se na sljedećim stranicama:

Stranica Scala zajednice | Stranica reakcije zajednice | Stranica zajednice hrđe | Stranica Ember zajednice | Stranica uglatih izvora

Ali potrebno je više od samo dugačkih popisa sadržaja da biste dobili privlačnu stranicu u zajednici! Ovi beskrajni popisi lako postaju neodoljivi za one koji tek započinju putovanja programerima. React i Rust posebno su loši prijestupnici. Naravno, sadržaj je tu, ali nije dobrodošao niti je istraživački.

Dizajn zajednice

Većina ovih pitanja otkrivanja, kao i obično, lako se može prevladati dobrim dizajnom. Navedenih osam odjeljaka vrlo su različite vrste sadržaja. Stoga se može očekivati ​​da su i njihovi zahtjevi za prezentacijom vrlo različiti.

Ne postoji internetska stranica koja je pregledana na koju bih mogao ukazati i reći „savršeno su to uradili“. Nekoliko je sjajnih primjera zanimljivog dizajna za izlaganje:

Scala Comms kanaliEmber's Community Sizzle Reel je srdačna dobrodošlicaMapa susreta Ember

Sve u svemu, ovaj je prostor zreo za inovacije. Moj savjet: Prvo odredite sadržaj koji će Čvor pružiti za svaki od osam prethodno navedenih odjeljaka. Zatim - nemojte sve to baciti u datoteku za označavanje i nazvati završenom - izađite u svijet i pronađite lijepe primjere tog žanra sadržaja koji se učinkovito prikazuje.

Na primjer:

Kartice za medij Primijetite zaključavanje izdanja na dnu.

Vijesti: Prikazujemo popise članaka ili publikacija? Medij to sve svodi na znanost.

Gitter's korisničko sučelje za popise u sobi

Comms: Možemo potražiti platforme poput Gitter ili Slack kako najbolje predstaviti popise chat soba. Ako ste osobito pronicljiv čitatelj, primijetit ćete da ova prezentacija izgleda poznato kao widget Scala's Comms Channel!

https://www.dotconferences.com/attend

Konferencije: Glavni organizatori konferencija poput Dot Conferences imaju vrlo atraktivne metode za prikaz izbora svojih konferencija.

Vodiči za doprinos

Ovaj članak preporučuje da smjernice za doprinose također sudjeluju u zajednici. Međutim, na mnogim je mjestima doprinos dovoljno važan da bi se dobio vrhunski navigacijski članak.

Bez obzira na lokaciju, ove su stranice obično gušće informacije od ostalih dijelova web mjesta. To je u redu, jer kad posjetitelj počne istraživati ​​ove stranice, obično se već kupuju u dodatnom radu na probavljanju guste dokumentacije. Kao i uvijek, pri sastavljanju ovih vodiča koristite najbolju prosudbu - nitko ne voli zid teksta, bez obzira koliko ste napredni stekli vještinu kodiranja.

Blog

Na internetu postoji toliko članaka koji raspravljaju o tome koliko je točno blogiranje ili mrtav bloger postao u posljednjih pet godina. Od uspona i kasnijeg preuzimanja svjetskih medija, posvećeni blogovi počeli su se naslanjati na dobro osmišljene strategije društvenih medija. Unatoč tome, na mnogim web lokacijama s dokumentacijom i dalje postoji posvećeni blog - zašto?

Ako pitate svih deset web lokacija koje su pregledane u ovom članku, vjerojatno ćete dobiti dvanaest različitih odgovora. Međutim, ovaj autor vjeruje da blogovi dokumentacije imaju jedinstvenu svrhu: Nitty-gritty bilješke o izdanju i zapisnici promjena. Uostalom, kako je jedan poznati čovjek jednom rekao ...

Držite do točke!
- Ovaj autor, prosinac 2017

Unatoč našim najboljim namjerama, web stranica projektne dokumentacije nije mjesto na kojem većina korisnika otkriva vijesti o platformi. To je posao tvrtke Medium, Twittera, GitHub-a, YouTubea, popisa za slanje zajednica u zajednici itd. Ovi su kanali dizajnirani kako bi maksimalizirali društveni domet i isporučili sadržaj tamo gdje su već vaši korisnici.

Blogovi poput onih na web-lokacijama React, Go i Scala imaju neučinkovitu mješavinu komada pahulja, izdanja izdanja i izloga.

Blogovi poput onih na web lokacijama Ember, Ruby i Angular gotovo isključivo objavljuju bilješke o izdanju, izvješća o napretku značajki na niskoj razini i sigurnosna ažuriranja ili se samo povezuju s medijskom publikacijom.

Srećom po nas, blog Node.js već uvelike slijedi model izdanja-bloga! Moja jedna preporuka je dodati gornju prodaju za vrh za korisnike koji traže blog o Nodeovoj zajednici i premjestiti sve dijelove koji su usmjereni na zajednicu u medijima koji su objavljeni na posljednjim člancima i dovršiti podjelu odgovornosti.

Podnožje

Odjeljak za bonus! Kao što je gore spomenuto, podnožje je divan dom za stranice koje ne zadovoljavaju naše kriterije korištenja u slučaju 90%. Ovaj je sadržaj dovoljno važan da se veza pojavljuje na svakoj stranici web mjesta, ali nije potrebna da svi korisnici vide drugu koju stignu. Iako su ove stranice manje vidljive od njihovih kolega s primarnim navikama, zaslužuju da budu dizajnirane s jednako pažnjom i pažnjom korisnika kao i bilo koji drugi sadržaj na najvišoj razini.

Te stranice mogu sadržavati, ali nisu ograničene na:

  1. vladavina
  2. sigurnosti
  3. pravni
  4. Sredstva robne marke
  5. Tim
  6. Link na web mjesto Fondacije čvorova

Ići naprijed

Nadam se da ovaj članak služi kao polazna točka za rasprave u zajednici Node.js o sljedećim koracima. Ova konkurentna analiza samo je početak dugog procesa dizajniranja, a ja sam uzbuđen što sam se pridružio razgovoru!

Pazite na daljnje članke s detaljnim detaljima stranica s žičanim mrežama, visokim podsmjehom vjernosti i, nadamo se, uskoro, potpunim prekidom novoizgrađenog nodejs.org

Slobodno komentirajte na dnu ovog članka svoja omiljena iskustva s razvojnim programerima sa cijelog interneta ili se pridružite neprekidnim razgovorima koji se događaju na Node.js Github Repo - treba još puno posla i Radujem se što ću vas vidjeti tamo!