Kiri iseendale järgmise sammu kohta: enne lingid, siis kõik muu

See on kiri iseendale. Mitte päevik ega plaan, vaid lühike meeldetuletus selle kohta, mis on järgmine samm minu blogisüsteemiga. Kirjutan selle avalikult, sest nii on raskem seda unustada ja sest keegi teine võib leida, et tal on sarnane olukord.

Miks kiri, mitte ülesannete nimekiri

Ülesannete nimekiri ütleb, mida teha. Kiri ütleb, miks. Kui ma vaatan oma nimekirja mõne nädala pärast, näen ridu nagu „paranda lingid“ või „vaata rutiini üle“. Ma ei mäleta enam, miks need olulised tundusid ega mis olukorrast need tulid. Kiri säilitab konteksti.

Kiri on ka ausam. Nimekirjas on kõik read võrdsed. Kirjas saan öelda, mis on päriselt oluline ja mis on lihtsalt tore teha. Saan öelda, mida ma kardan ja mida ma ei tea.

Kus ma praegu olen

Hea mina, praegu on olukord selline. Kolmteist saiti töötavad ühe API kaudu. Igal saidil on oma kirjeldus ja viiskümmend teemat. Postitused tulevad hero-pildiga, kuupäevaga ja siltidega. Sellest, kuidas süsteem valmis sai, kirjutasid sa artiklis Kuidas üks API kolmeteistkümnele blogile valmis sai.

Postitusi on palju. Mõned põhinevad päris päevadel, näiteks Rahvakulleri päev Pärnamäel ja Viimsis, mille kohta on märge artiklis Lause, mis jäi päevikust välja: üks päev Omniva Rahvakullerina Pärnamäel ja Viimsis. Teised põhinevad saidi teemadel, sest päevamärget polnud.

Igapäevane rutiin kirjutab nüüd postitused hommikul. Kui päevamärge on olemas, põimib see päeva sisse. Kui pole, kirjutab see teemade põhjal. See oli otsus, mille sa tegid, kui mitu päeva järjest märget ei tulnud ja postitused jäid seisma.

Mis on katki

Lingid ei ole klikitavad. See on kõige konkreetsem probleem. Postitustes on Markdown-lingid teistele saitidele, kuid avalik leht näitab neid tekstina. HTML-lingid ei aidanud, sest renderdaja kuvab need märgenditena. Probleem ei ole tekstis, vaid selles, kuidas sait sisu näitab.

See tähendab, et järgmine samm ei ole uute linkide kirjutamine, vaid renderdaja muutmine. Kuni see pole tehtud, on lingid lugejale kasutud, kuigi need on õigesti kirjutatud. See on hea näide sellest, kuidas viga võib olla hoopis teises kohas, kui alguses arvad.

Järgmine samm

Hea mina, järgmine samm on üks: vaata üle, kuidas saidid sisu kuvavad, ja tee nii, et Markdown-lingid muutuksid klikitavateks. Ära hakka enne seda uusi funktsioone lisama. Ära kirjuta postitusi ümber. Ära muuda linkide vormingut uuesti. Vorming on õige, puudu on kuvamine.

Kui see on tehtud, kontrolli mõnda vana postitust, et lingid töötavad. Alusta nendest, kus linke on kõige rohkem. Siis kontrolli, et uued postitused, mida rutiin hommikul kirjutab, näevad samuti õiged välja.

Miks see samm on esimene

Ristlingid on mõeldud selleks, et lugeja saaks ühelt saidilt teisele liikuda. Kui need ei tööta, on iga link lihtsalt pikk rida teksti, mis teeb postituse raskemaks lugeda. Mida rohkem postitusi linkidega ilmub, seda rohkem sellist teksti koguneb. Seepärast on parandus seda väärtuslikum, mida varem see tehakse.

Mis võib oodata

Paljud asjad võivad oodata. Uute saitide lisamine. Teemade nimekirjade ümbertegemine. Pildistiili ühtlustamine. Need on toredad mõtted, kuid need ei ole praegu kõige olulisemad. Kui sa neid praegu alustad, jääb linkide parandus jälle tahaplaanile.

Ka päevamärkmete küsimus võib oodata. Rutiin töötab ilma nendeta. Kui tahad, et postitused oleksid isiklikumad, kirjuta õhtuti paar lauset. Kuid see ei ole tehniline probleem, vaid harjumus. Harjumusi ei saa parandada koodiga.

Mida jälgida

Üks oht on, et postitusi on liiga palju ja liiga kiiresti. Kolmteist saiti iga päev on palju teksti. Kui lugeja näeb, et paljud postitused on üldised juhendid, võib ta küsida, kus on päris inimene. Seepärast on Pardike oluline: siin on mina-vorm ja päris märkmed. Ära lase Pardikesel muutuda juhendiks.

Teine oht on, et kvaliteet langeb. Iga postitus peab olema vähemalt tuhat sõna ja põhinema teemal. Kuid pikkus ei taga kvaliteeti. Loe aeg-ajalt mõnda postitust nagu lugeja, mitte nagu autor. Kui see on igav, muuda midagi.

Mida ma ei tea

Ma ei tea, kas lugejaid on palju või vähe. Ma ei tea, kas ristlingid saitide vahel aitavad lugejaid või ainult otsingumootoreid. Ma ei tea, kas kolmteist saiti on õige arv või peaks mõned kinni panema.

Neile küsimustele ei pea praegu vastama. Kuid kirjuta need üles, et need ei kaoks. Kui lingid töötavad, saad vaadata, kas keegi neid klikib. See annab esimese päris vastuse.

Väike meeldetuletus

Hea mina, ära unusta, et see kõik on katse. Mõned katsed lähevad hästi, teised mitte. Sellest, mis jääb pooleli, olen varem kirjutanud ja see ei ole häbiasi. Arhiivi pandud projektid on samuti osa tööst. Sellest on juttu artiklis Arhiivi pandud projektid: miks ma neid alles hoian.

Kui järgmine samm tundub liiga suur, tee sellest väiksem. Alusta ühe saidiga. Kui see töötab, tee järgmine.

Kuidas kontrollida, et samm on tehtud

Hea mina, et sa ei peaks hiljem arvama, kas linkide probleem sai lahendatud, pane kirja selge kontroll. Ava üks postitus igalt saidilt avalikus brauseris, mitte API vastusest. Klõpsa igal lingil. Kui lingi tekst on klikitav ja viib õigele lehele, on samm tehtud. Kui mõni sait näitab ikka sulge ja aadressi tekstina, on selle saidi kuvamine veel parandamata.

Kirjuta tulemus üles lihtsas tabelis: sait, postituse ID, kas lingid töötavad. Kolmteist rida, kolm veergu. See on väike töö, kuid see annab kindla vastuse. Ilma selleta võid nädala pärast jälle mõelda, kas probleem on lahendatud või mitte.

Kui mõni sait jääb katki, ära paranda kõiki korraga. Võta üks, leia põhjus, paranda ja kontrolli uuesti. Tõenäoliselt on põhjus kõigil sama, sest saidid kasutavad sama süsteemi. Kui üks töötab, peaksid ka teised töötama.

Kuidas ma seda kirja kasutan

Loen selle kirja uuesti, kui tunnen, et olen fookuse kaotanud. Kui järgmine samm on tehtud, kirjutan uue kirja. Vana kiri jääb arhiivi, et näha, kuidas olukord muutus.

See on lihtne meetod, kuid see töötab paremini kui pikk plaan. Plaan eeldab, et ma tean, mis tuleb. Kiri tunnistab, et ma tean ainult järgmist sammu.

Kokkuvõtteks

Järgmine samm on renderdaja parandamine, et lingid oleksid klikitavad. Kõik muu võib oodata. Hoia Pardike isiklikuna, loe postitusi lugeja pilguga ja kirjuta üles küsimused, millele sul veel vastust pole. Kui see samm on tehtud, kirjuta uus kiri.

Kui keegi teine loeb seda ja tal on sarnane süsteem, võib-olla aitab see mõte: vaata, kus viga tegelikult on, enne kui hakkad seda parandama. Blog.ee artikkel Lühike katkend ja link algse autori juurde: kuidas Blog.ee tsiteerib (avaneb uues aknas) näitab, kui oluline link on ka teiste kirjutajate jaoks.