Ukurasa huu uko kwenye ujenzi kabisa!

Tafadhali bonyeza hapa kusaidia David McMurrey lipie bili yake ya mwenyeji wa wavuti:
Toa kiasi chochote kidogo unachoweza!
Uandishi wa Kiufundi Mtandaoni utaendelea kuwa bure.

Kitabu cha Mtandaoni cha Uandishi wa Kiufundi: Kumbukumbu za Kutolewa

Taarifa ifuatayo imebadilishwa kwa idhini kutoka kwa makala ya appcues.com (iliyorekodiwa hapa chini).

Kwa nini nyingi ya taarifa za kutolewa hazisomwi (na jinsi ya kutatua hilo)

Maelezo mengi ya toleo hayasomwi. Si kwa sababu watumiaji hawajali kile kinachobadilika katika bidhaa, bali kwa sababu maelezo hayo yameandikwa kwa ajili ya timu iliyotoa kipengele, si kwa mtu anahitaji kuelewa.

Labda umekwisha ona hii kabla: noti ya kuachilia inayofungua na "Imeanzishwa safu ya kuhifadhi data iliyoimarishwa kwa ajili ya kuongeza kupitia" ilhali kile ambacho mtumiaji alikuwa haja kusikia ni "Ripoti zako sasa zinapakua mara mbili kwa kasi." Toleo la kwanza linakaguliwa. La pili linaongeza matumizi.

Pengo hilo ni muhimu zaidi kuliko timu nyingi zinavyofahamu. Nota ya kutolewa ni wakati wa mawasiliano ya bidhaa. Ni dirisha kati ya kutolewa na kupitishwa. Ikifanywa vizuri, watumiaji watachunguza kile ulichokijenga. Ikiwa itakosekana, kipengele hicho kinaweza kuwa hakijatumwa.

Makala hii inakupa unachohitaji kufunga pengo hilo: mifano 13 ya noti za kutolewa kutoka kwa kampuni zinazofanya hivi vizuri (zilizopangwa kulingana na kile kinachofanya kila moja kuwa ya thamani ya kusoma), kigezo unachoweza kuchukua na kubadilisha leo, na mwongozo wa kuandika hatua kwa hatua unaoshughulikia misingi. Iwe wewe ni meneja wa bidhaa unayeandika noti yako ya kwanza ya kutolewa au mfanyakazi wa masoko ya bidhaa anayeimarisha mchakato, utaondoka na kitu unachoweza kutumia mara moja.

Je, nota za toleo ni nini?

Kumbukumbu ya kutolewa ni ripoti fupi inayokabiliwa na watumiaji iliyochapishwa pamoja na programu mpya au zilizosasishwa. Inaelezea ni nini kilichobadilika, kwa nini ni muhimu, na kinaathiri nani. Kwa kutolewa kwa mpya, kumbukumbu za kutolewa zinaweza kuwapa watumiaji muhtasari wa kile ambacho bidhaa inafanya. Kwa usanidi wa bidhaa zilizopo, kumbukumbu zinaelezea ni nini kipya, ni nini kimeimarishwa, na ni nini kimefanyiwa marekebisho tangu toleo la mwisho.

‍

Mfano wa noti za kuachiliwa ukionesha toleo za zamani

‍

Maelezo ya lia vs. mabadiliko

Maneno haya yanatumika kwa kubadilishana, lakini ni mambo tofauti. Maelezo ya toleo yanaelezea toleo maalum au sasisho kwa undani: kile kilichobadilika, kwanini kina umuhimu, nani kinahusisha. Tofauti kati ya mabadilishano ya taarifa na maelezo ya toleo inafaa kueleweka: mabadilishano ya taarifa ni kumbukumbu inayoendelea ya maelezo yote ya toleo kwa muda. Fikiria hii kama archive. Bidhaa nyingi huzihifadhi zote: maelezo ya toleo binafsi kwa kila sasisho, na ukurasa wa mabadilishano ya taarifa ambapo yote yanaishi pamoja kwa mpangilio wa kinyume cha muda.

Kuhifadhi rekodi hiyo muhimu ni muhimu. Inawaonyesha wateja kwamba bidhaa inaboreka kwa kuendelea na kwamba mabadiliko ya hivi karibuni yanajenga juu ya yale ya zamani. Pia inahakikisha kwamba kampuni inasikiliza maoni na ina dhamira ya kuboresha uzoefu wa mtumiaji.

Aina za taarifa za toleo

Si kila sasisho linapaswa kutendewa sawa. Muundo na kina cha taarifa zako za kutolewa zinapaswa kuendana na kiwango cha mabadiliko:

Maelezo ya toleo kuu: Kipengele kipya, mabadiliko makubwa ya UI, uwezo mpya. Haya yanastahili kutolewa kwa undani zaidi kwa picha, muktadha juu ya kwanini mabadiliko yafanyike, na mwongozo wazi juu ya jinsi ya kuyatumia.

Maelezo ya sasisho madogo: Kuboresho kidogo, mabadiliko madogo ya UX. Format fupi inafanya kazi hapa, kawaida mistari mmoja hadi mitatu kwa kila kipengele.

Maelezo ya kurekebisha makosa: Masuala yaliyo sababishwa yamekutatuliwa. Muundo wa orodha, lugha rahisi, ukiangazia kile mtumiaji alikumbana nacho kabla dhidi ya kinachotokea sasa.

Kumbukumbu za usalama: Fupi na za ukweli. Kuweka kipaumbele kwa kile kilichokuwa hatarini na kile kilichorekebishwa bila maelezo ya kiufundi yanayofanya kuvurugika.

Kwa nini taarifa za kuachia ni muhimu

Ni daraja kati ya usafirishaji na matumizi. Watumiaji wanaelewa nini kimebadilika wana nafasi kubwa ya kuchunguza na kupokea huduma mpya. Tahariri za toleo ni wakati wa mawasiliano ya bidhaa ambapo unatafsiri kile timu ya uhandisi imejenga kuwa kitu ambacho mtumiaji anataka kujaribu. Bila tafsiri hiyo, huduma zinabaki bila kugundulika, na kupitishwa kwa huduma hupata changamoto kwani juhudi ambazo timu yako ilitumia katika kuzitengeneza hazifiki lengo lake.

Wanapunguza mzigo wa kazi wa timu yako ya usaidizi. Taarifa za kutolewa kwa njia ya proaktif hupunguza maswali ya ndani kuhusu kwa nini kitu kinaonekana tofauti au kinafanya kazi tofauti. Wakati watumiaji wanakutana na mabadiliko ambayo hawakutarajia, wanafungua tiketi ya usaidizi. Wakati tayari wamesoma maelezo wazi, hawawezi kufanya hivyo. Hesabu ni rahisi: andika mabadiliko kabla ya watumiaji kukutana nayo.

Wanaojenga uaminifu wa wateja na uhifadhi. Kumbukumbu za kutolewa zinazoonekana na za mara kwa mara zinaashiria kwamba bidhaa inaboresha kwa kiwango cha juu. Kwa wateja wanaotathmini kama waongeze au kuimarisha, kumbukumbu za mabadiliko yenye afya ni ushahidi kwamba bidhaa inasonga mbele. Kwa wateja waliotuma maombi ya vipengele, kuona maoni yao yakiakisiwa katika kumbukumbu za kutolewa hujenga uaminifu zaidi.

Wanachambua mwelekeo wa ndani. Nidhamu ya kuandika taarifa nzuri za kutolewa, hasa kujibu "nini kimebadilika, kwa nani, na kwanini ni muhimu," inawashawishi timu za bidhaa kuwasiliana kwa wazi ndani ya shirika. Masoko ya bidhaa, mafanikio ya mteja, na mauzo yote yanafaidika wakati mawasiliano ya kutolewa yanaeleweka na yanafanana. Taarifa ya kutolewa mara nyingi inakuwa chanzo cha ukweli ambacho timu nyingine zinakirejelea wanapozungumza na wateja kuhusu yaliyopya.

Nini cha kujumuisha katika noti za kutolewa

Fikiria hili kama muundo wa taarifa ya kutolewa. Kila taarifa mahiri ya kutolewa inashughulikia vipengele hivi, ingawa kina kinaweza kutofautiana kulingana na ikiwa unatangaza kipengele kikuu au kurekebisha kasoro ya kawaida:

Kichwa: Jina la bidhaa, nambari ya toleo au tarehe, na mazingira ikiwa inahitajika (mtandao, iOS, API, n.k.).

Muhtasari wa mabadiliko: Sentensi moja au mbili zikielezea kile kinachoshughulikia toleo hili na kinaathiri nani. Hii ni sehemu ambayo watumiaji wanasoma kwanza, hivyo iwe na maana.

Mambo Mapya: Yamepewa majina, na athari fupi kwa mtumiaji. Anza na kile ambacho mtumiaji sasa anaweza kufanya, si utekelezaji wa kiufundi.

Marekebisho: Nini kimebadilika kutoka mtazamo wa mtumiaji. "Matokeo ya utafutaji sasa yanapakia kwa haraka 40% zaidi" ni bora kuliko "Bomba la utafutaji limeimarishwa."

Kurekebisha makosa: Maelezo rahisi kuhusu kile ambacho mtumiaji alikiona hapo awali na kile kinachotokea sasa. "Dashibodi sasa haiangazi tena inapochuja kwa kipindi cha tarehe" inamwambia mtumiaji hasa kile kilichokuwa kibaya na kwamba kimeshatekelezwa.

Masuala au mipaka inayojulikana: Ikiwa jambo fulani halijatatuliwa kabisa, sema hivyo. Watumiaji wanaheshimu uwazi zaidi kuliko wanavyokuwa na chuki kwa kasoro.

Jinsi ya kuandika taarifa za kutolewa

Kujua ni nini cha kujumuisha ni msingi. Jinsi unavyoandika inatengeneza kama mtu yeyote atasoma. Hatua hizi saba zimepangwa kwa mtiririko: anza na kile cha kusema, kisha jinsi ya kusema, halafu jinsi ya kuwasilisha.

1. Zingatia mtumiaji, si kipengele

Hii ndiyo kanuni muhimu zaidi katika kuandika taarifa za toleo. Kila mabadiliko yalijengwa kutatua tatizo au kufungua uwezo kwa mtumiaji. Anza na hilo.

Instincti ni kuelezea kile ambacho timu yako imejenga. Pinga hilo. Badala yake, elezea kile ambacho mtumiaji sasa anaweza kufanya (au kile ambacho hayahitaji kushughulika nacho tena).

Kabla: "Imepangwa usindikaji wa kundi kwa ajili ya mauzo ya data na saizi za kipande zinazoweza kubadilishwa."

Baada ya: "Sasa unaweza kusafirisha seti kubwa za data bila mchakato kushindwa. Usafirishaji ambao uliwahi kushindwa baada ya mistari 10,000 sasa unashughulikia hadi 500,000."

Toleo la pili linazungumzia uzoefu wa mtumiaji.

2. Fanya kusudi la mabadiliko kuwa wazi.

Watumiaji wanaosoma taarifa za kutolewa wanataka mambo mawili: kile kinachobadilika na kama kinawagusa. Fanya majibu yote mawili yaonekana wazi katika sentensi ya kwanza ya kila kipengele.

Uwazi ni muhimu kwa sababu watumiaji wa mtandao hawasomi kwa mstari mmoja. Wanatazama. Hivyo, fanya taarifa zako za kutolewa ziwe bora kwa kutazama. Panua maneno muhimu. Tumia maandiko yenye nguvu kwa majina ya vipengele na aina za mabadiliko. Panga habari muhimu zaidi katika kila mstari.

Kabla: "Hitilafu imekuzwa na sasisho zimewekwa."

Baada ya: "Tulirekebisha hitilafu iliyoleta ajali zisizotarajiwa wakati wa kubadili kati ya programu. Kubadili programu sasa ni thabiti katika vifaa vyote vinavyoungwa mkono."

Version ya kwanza ni fupi lakini haisemi chochote kwa mtumiaji. Version ya pili bado ni fupi lakini inajibu maswali ambayo mtumiaji hakika ana.

3. Tumia lugha rahisi

Maelezo ya toleo yanaweza kutumikia madhumuni mbalimbali: kutangaza vipengele vipya, kujenga uhusiano na mtumiaji, kusaidia watu kupata suluhisho. Lakini hakuna chochote kimoja kinachofanya kazi wakati maelezo hayo yamejaa maneno ya kiufundi ambayo ni ya kueleweka tu na timu yako ya uhandisi.

Ila kama unajua kwamba hadhira yako itaelewa lugha ya kitaalamu kwa urahisi, inakubalika kupunguza matumizi ya maneno ya kitaalamu. Tumia kauli rahisi na zinazoweza kueleweka. Mtihani mzuri: isome taarifa ya kutolewa kwa sauti kwa mtu ambaye haelewi background ya kiufundi. Ikiwa wataelewa, watumiaji wako pia wataelewa.

Kabla: "Tumeanzisha uwezo wa kutumia picha za Graphics Interchange Format (GIF) ambazo zinajumuisha kama vile compression ya faili, uwazi, kuchanganya, na uhifadhi wa picha nyingi ndani ya faili moja kwa huduma yetu ya ujumbe."

Baada ya: "Sasa unaweza kutumia GIF katika huduma yetu ya ujumbe."

Lugha rahisi si kupunguza vitu. Ni kuheshimu muda wa mtumiaji wako.

4. Ongeza picha kwa ajili ya mabadiliko magumu

Ikiwa taarifa yako ya kutolewa inahitaji maelezo marefu ya maandishi, hiyo ni ishara ya kuongeza picha badala yake. GIF fupi au picha iliyoongezewa maelezo inayoonyesha kipengele kikifanya kazi inawasilisha zaidi kuliko aya mbili za maelezo kwa mabadiliko yoyote ya UI.

Hii ni muhimu hasa kwa:

Vipengele vipya vya UI au mabadiliko ya mpangilio (onyesho la kabla na baada)

Mikakati mipya au vipengele vya hatua nyingi (rekodi ya skrini ya sekunde 15)

Vipengele vya uonyeshaji wa data (picha ya skrini ya matokeo halisi)

Picha hupunguza mzigo kwa msomaji na kufanya maelezo yako ya kutolewa kuwa ya kusahaulika zaidi. Wakati mabadiliko ni ya kawaida kuona, onesha kwa kuona.

5. Andaa kwa ajili ya kusoma

Watumiaji wanakuwa wapumbavu wanapoulizwa kusoma ukuta wa maandiko. Hifadhi mambo yakiwa na mpangilio na kugawanywa kwa vichwa vya juu, makundi, mizunguko ya alama, na mapumziko ya aya. Kupanua sehemu kubwa za maandiko husaidia watumiaji kupata mabadiliko gani yanawahusu bila kusoma kila kitu.

Mifumo bora ya shirika ni pamoja na:

Kuweka mabadiliko kwa aina: vipengele vipya, maboresho, kurekebisha makosa

Kutumia lebo au vitambulisho (kama "Mpya," "Bora," "Imepatiwa Suluhisho") kwa ajili ya kusoma haraka

Kuongeza muhtasari mfupi juu kwa watumiaji ambao wanataka tu mambo muhimu.

Kutumia sehemu zinazoweza kukunjwa kwa maelezo ya kina ya kiufundi ambayo baadhi ya watumiaji wanahitaji tu.

6. Tumia kipande cha kazi na ufuate.

Uthabiti ni kipengele, si kizuizi. Wakati taarifa zako za kutolewa zinafuata muundo unaoweza kutabiriwa, watumiaji wanajifunza wapi waangazie habari wanazoziweka moyo. Watatumia muda mdogo katika kuchambua na muda mwingi katika kuelewa.

Chagua muundo (kuna mmoja katika sehemu inayofuata unaweza kunakili), uquote kwa bidhaa yako, na utembeze kila wakati. Hii pia inafanya mchakato wa uandishi kuwa wa haraka kwa timu yako, kwa kuwa muundo tayari umeamua.

7. Linganisha sauti ya chapa yako, si sauti yako ya uhandisi.

Maelezo yako ya kutolewa yanapaswa kuonekana kama chapa yako, si kama ujumbe wa kujitolea. Ikiwa chapa yako ni ya joto na inayopatikana, maelezo yako ya kutolewa yanapaswa kuwa hivyo pia. Ikiwa chapa yako ni sahihi na ya kitaaluma, pandisha kiwango hicho.

Funguo ni kuwa wa kweli bila kupita kiasi. Unaweza kuongeza utu bila kuhatarisha uwazi. Joto kidogo linaweza kufanya mambo kuwa bora, lakini kujitangaza kwa nguvu kunaharibu uaminifu. Mwongozo mzuri: 80% ya maudhui yanapaswa kuwa habari yenye faida halisi, na asilimia 20 tu inapaswa kuonyesha nafasi ya chapa au sauti.

Ni nini cha kuepuka: "Tupo hapa kubadilisha mtindo wako wa kazi, jambo ambalo tumefanya kwa mafanikio na kila sasisho. Karibu. Marekebisho yetu mapya yana asilimia 50 ya matumizi ya nishati kidogo."

Bora: "Kuuruhusu: Programu sasa inapunguza matumizi ya nishati ya mtumiaji wa mwisho kwa 50%. Mojawapo ya njia nyingi tunazofanya kazi kuelekea mustakabali endelevu zaidi."

Toleo la kwanza linaongeza thamani ya chapa na kutoa ahadi nyingi kabla ya kutaja mabadiliko. Toleo la pili linakueleza kuhusu suluhu, kisha linaongeza mtazamo wa chapa kwa njia ya asili.

Kipengele cha kutolewa maelezo

Hapa kuna kiolezo cha notes za toleo ambacho unaweza nakala na kubadilisha. Kinashughulika na mambo muhimu kwa sasisho nyingi. Badilisha kina kulingana na wigo wa utoaji wako: toleo kuu linapata maelezo zaidi kwa kipengele, toleo dogo linaweza kufupisha sehemu, na toleo la kurekebisha makosa pekee linaweza kupuuzia kabisa sehemu ya "Nini kipya".

[Jina la bidhaa] hati za kutolewa - [Nambari ya toleo au tarehe]

Muhtasari: [Muhtasari wa mistari 1-2 kuhusu kile kinachoshughulikia kutolewa hiki na kinaathiri nani]

Nini kipya

- [Jina la kipengele]: [Kinafanya nini na kwanini ni muhimu kwa mtumiaji]

- [Jina la Kipengele]: [Kinafanya nini na kwanini ni muhimu kwa mtumiaji]

Mabadiliko

- [Nini kilibadilika] - [Jinsi inavyoathiri uzoefu wa mtumiaji]

Makosa yaliyotatuliw

- [Kile ambacho mtumiaji alipitia kabla] - [Kinafanyika sasa]

Masuala yanayojulikana

- [Maelezo ya tatizo] - [Njia mbadala au muda ikiwa inapatikana]

Maswali? [Kiungo cha hati za msaada au mawasiliano ya msaada]

Jinsi ya kubadilisha kiolezo: Kwa toleo kuu lenye vipengele vipya vitatu, panua kipengele cha "Nini kipya" kwa aya kila kipengele. Kwa toleo dogo lenye maboresho madogo matano, unaweza kuunganisha "Nini kipya" na "Maboresho" kuwa orodha moja. Kwa toleo la kurekebisha kasoro pekee, anza na marekebisho na uondoe kabisa sehemu za vipengele. Muundo unapaswa kuhudumia maudhui, si vinginevyo.

13 mifano ya noti za kutolewa, zimeandaliwa kulingana na kile wanachofanya vizuri zaidi

Mifano iliyo chini imepangwa katika makundi matano kulingana na kile ambacho kila kampuni inafanya vizuri katika noti zake za kutolewa. Kwa kila mfano, utaona: kile kampuni inafanya, kile noti zao za kutolewa zinavyofanya vizuri, na somo maalum, linaloweza kutumika unaloweza kuzingatia.

Taarifa Zinazohusiana

https://learn.microsoft.com/en-us/microsoft-365/copilot/release-notes?tabs=all MFANO HALISI! https://learn.microsoft.com/en-us/sharepoint/dev/spfx/release-1.23.0 MFANO HALISI! https://slite.com/learn/release-notes https://documentero.com/templates/it-engineering/document/release-notes/ https://projectmanagers.net/7-free-release-notes-templates/ https://www.smartsheet.com/content/release-note-examples https://clickup.com/blog/how-to-write-release-notes/ https://www.releasenotes.io/ https://clickup.com/blog/release-notes-software/ https://www.launchnotes.com/blog/release-notes-examples https://www.geeksforgeeks.org/software-engineering/overview-of-software-release-note/ mifano 13 ya maelezo ya kutolewa (na kile kinachofanya yafaulu). appcues.com

Habari na mipango inayotolewa na admin@mcmassociates.io.