Bruk av ord og uttrykk før de har blitt introdusert, forklaring og navigasjon til forklaring

[Maritims]

Jeg har i andre sammenhenger lest lærebøker hvor bøkene kommer seg selv i forkjøpet ved å bruke ord og uttrykk før de er introdusert. Dette kan være ganske frustrerende for den som er ny til stoffet. Dette er en lett felle å gå i som vi burde være oppmerksomme på når vi utarbeider innhold på koding.no.

Et eksempel på dette finnes på koding.no/opplaering i avsnittet om frontend-utvikling:

Frontend utviklere jobber på å implementere design og brukergrensesnitt, som regel nettsider og apper. Hvis du har et øye for design og liker å jobbe med brukergrensesnitt, så er frontend utvikling noe for deg.

Deler av jobben innebærer å jobbe med designere og UX-ere for å lage gode brukeropplevelser, og å jobbe med backend utviklere for å få systemene til å henge sammen.

Det er også viktig å ha god forståelse for hvordan brukere bruker systemene, og å teste at systemene er tilgjengelige og lette å bruke for alle mennesker, uavhengig av funksjonsevne.

Som helt ny ville jeg spurt meg selv "hva er en designer?", og jeg ville ihvertfall lurt på hva en "UX-er" er for noe. Det er ikke ment at denne saken kun skal handle om dette ene tilfellet, men heller ta opp et viktig poeng: La oss ikke bruke ord og uttrykk før vi har forklart hva de betyr. Kanskje denne saken kan være en samlesak for dette poenget.

Det blir etterhvert mange ord og uttrykk som skal forklares, og selv om vi forklarer det eller annet sted tenker jeg det kan være lurt å legge opp til at man enkelt kan navigere til betydningen av ting og tang. Kanskje vi kunne utviklet støtte for å trykke på enkelte ord som så leder brukeren frem til forklaringen slik som man gjør på Wikipedia f.eks?

Tanker?

[imp-dance]

Det hadde vært stilig med en slags pop-over funksjon for interne artikler. Ser for meg en link som har dashed underline, og når bruker har musen over linken så får bruker opp en forhåndsvisning av artikkelen (klikk går til artikkelen). Kan fungere bra for artikler som definerer nye ord. Kan se om jeg får kikket på dette i løpet av starten av neste uke - blir litt travel i helgen.

[aruudboy]

Jeg har så vidt begynt å dyppe tærne i både git og koding.no, og tror jeg med min bakgrunn foreløpig kan bidra mer med det språklige enn med selve kodingen av nettsiden. Med det sagt - dette tror jeg er et veldig viktig moment i lys av hva jeg har forstått å være målgruppen til koding.no.

En pop-over med dashed underline slik vg og nrk bruker, der kun definisjonen av uttrykket står, er det et alternativ?

Og: Hva er egentlig bra kutyme rent kodemessig for forslag til endringer? (Både her og rent generelt?) Skal jeg bare lage en PR på endringsforslag, eller bare legge inn kommentarer der jeg er usikker?

[imp-dance]

Og: Hva er egentlig bra kutyme rent kodemessig for forslag til endringer? (Både her og rent generelt?) Skal jeg bare lage en PR på endringsforslag, eller bare legge inn kommentarer der jeg er usikker?

Det beste er kanskje å lage issue først, ihvertfall hvis det innebærer store endringer. For mindre ting, eller ting du er sikker på vil bli akseptert inn, så er det bare å kjøre rett på PR. Dette er hovedsaklig i tilfelle endringene ender opp med å ikke bli akseptert, så kan det være kjipt å ha brukt mye jobb på å lage PR.

---

Ref oppdatering rundt min siste melding, så viste dessverre dette seg å være en vanskeligere jobb en jeg så for meg. Jeg tenker jeg tar en ny runde med idèmyldring på måter jeg kan få det til, men status er for nå ihvertfall at det ikke er gjort noe stor jobb rundt å lage implementasjonen.

[aruudboy]

Den er god - jeg tar sikte på å ta en runde med "språkvask" gjennom hele nettsiden nå i første omgang, og lager PR på det etterhvert. :)