Hujjatlarning sifatini qanday baholadik

Salom, Xabr! Mening ismim Lesha, men Alfa-Bank mahsulot jamoalaridan birining tizim tahlilchisiman. Hozir men biznes va yakka tartibdagi tadbirkorlar uchun yangi onlayn-bankni ishlab chiqyapman.

Analitik bo‘lsangiz, ayniqsa, bunday kanalda hujjatsiz va u bilan yaqindan ishlamasangiz, hech qaerga borib bo‘lmaydi. Hujjatlar esa har doim ko'p savollar tug'diradigan narsadir. Nima uchun veb-ilova tavsiflanmagan? Nima uchun spetsifikatsiyada xizmat qanday ishlashi kerakligi tasvirlangan, lekin u umuman bunday ishlamaydi? Nima uchun faqat ikkita odam, ulardan biri yozgan, spetsifikatsiyani tushunishi mumkin?

Hujjatlarning sifatini qanday baholadik

Biroq, aniq sabablarga ko'ra hujjatlarni e'tiborsiz qoldirish mumkin emas. Ishlarni osonlashtirish uchun biz hujjatlar sifatini baholashni o'tkazishga qaror qildik. Biz buni qanday qildik va bizning xulosalarimiz quyida keltirilgan.

Hujjatlarning sifati

"Yangi Internet Bank" atamasini o'nlab marta takrorlamaslik uchun men "NIB" atamasidan foydalanaman. Hozirda bizda tadbirkorlar va yuridik shaxslar uchun NIBni ishlab chiqish bo'yicha o'ndan ortiq jamoalar ishlamoqda. Har bir jamoa noldan yangi xizmat yoki veb-ilova uchun o'z hujjatlarini yaratadi yoki mavjudiga o'zgartirish kiritadi. Ushbu yondashuv bilan yuqori sifatli hujjatlarga erishish mumkinmi?

Hujjatlarning sifatini aniqlash uchun biz uchta asosiy xususiyatni aniqladik.

  1. U keng qamrovli bo'lishi kerak. Bu juda tantanali tuyuladi, lekin e'tiborga olish kerak. U amalga oshirilgan yechimning barcha elementlarini batafsil tavsiflashi kerak.
  2. U dolzarb bo'lishi kerak, ya'ni u yechimning joriy amalga oshirilishiga mos kelishi kerak.
  3. Bu aniq bo'lishi kerak, shunda uni qo'llagan kishi yechim qanday amalga oshirilganligini aniq tushunadi.

Xulosa qilish uchun: to'liq, dolzarb va tushunarli hujjatlar.

So'rov

Hujjatlarning sifatini baholash uchun biz u bilan bevosita ishlaydiganlar: NIB tahlilchilaridan so'rov o'tkazishga qaror qildik. Respondentlarga 1 dan 5 gacha bo'lgan shkala bo'yicha 10 ta bayonotni baholash so'ralgan (to'liq rozi emasman - to'liq roziman).

Bayonotlarda sifat hujjatlarining xususiyatlari va so'rov mualliflarining NIB hujjatlariga oid fikrlari aks ettirilgan.

  1. NIB ilovalari uchun hujjatlar yangilangan va ularni amalga oshirishga to'liq mos keladi.
  2. NIB ilovalarini amalga oshirish to'liq hujjatlashtirilgan.
  3. NIB ilovalari uchun hujjatlar faqat funktsional qo'llab-quvvatlash uchun kerak.
  4. NIB ilovalari uchun hujjatlar funktsional qo'llab-quvvatlash uchun taqdim etilgan paytda mavjud.
  5. NIB ilovasini ishlab chiquvchilari nima qilish kerakligini tushunish uchun hujjatlardan foydalanadilar.
  6. NIB ilovalari uchun hujjatlar ularning qanday amalga oshirilishini tushunish uchun etarli.
  7. NIB loyihalari uchun hujjatlar qayta ko'rib chiqilgan taqdirda (mening jamoam tomonidan) zudlik bilan yangilayman.
  8. NIB ilovasini ishlab chiquvchilari hujjatlarni ko'rib chiqadilar.
  9. Men NIB loyihalari uchun hujjatlarni qanday tayyorlashni aniq tushunaman.
  10. NIB loyihalari uchun hujjatlarni qachon yozish/yangilash kerakligini tushunaman.

Shunchaki “1 dan 5 gacha” degan javob kerakli tafsilotlarni ochib bermasligi aniq, shuning uchun odam har bir elementga sharh qoldirishi mumkin.

Biz bularning barchasini korporativ Slack tizimi orqali amalga oshirdik — biz shunchaki 15 ta tizim tahlilchisiga so‘rovnoma yubordik (to‘qqiz nafari Moskvadan va olti nafari Sankt-Peterburgdan). So'rov tugallangandan so'ng, biz 10 ta bayonotning har biri uchun o'rtacha reytingni yaratdik, keyin uni standartlashtirdik.

Bu shunday bo'ldi.

Hujjatlarning sifatini qanday baholadik

So'rov shuni ko'rsatdiki, tahlilchilar NIB arizalarini amalga oshirish to'liq hujjatlashtirilgan deb hisoblashsa-da, ular to'liq rozi emas (0.2). Aniq misol sifatida ular bir nechta ma'lumotlar bazalari va mavjud echimlardagi navbatlar hujjatlar bilan qamrab olinmaganligini keltirdilar. Ishlab chiquvchi tahlilchiga hamma narsa hujjatlashtirilmaganligini ko'rsatishi mumkin. Biroq, ishlab chiquvchilar hujjatlarni ko'rib chiqish g'oyasi ham aniq qo'llab-quvvatlanmadi (0.33). Bu shuni anglatadiki, amalga oshirilgan echimlarning to'liq tavsiflanmaganligi xavfi saqlanib qoladi.

Muvofiqlik biroz soddaroq - hali ham aniq konsensus mavjud emas (0,13), tahlilchilar hali ham hujjatlarni dolzarb deb hisoblashadi. Sharhlar shuni ko'rsatdiki, dolzarb bo'lgan muammolar o'rtadagidan ko'ra old tomonda ko'proq uchraydi. Biroq, biz orqa tomon haqida hech narsa eshitmadik.

Hujjatlarni qachon yozish va yangilash kerakligini tahlilchilarning o'zlari tushunadimi yoki yo'qmi, kelishuv ancha yakdil bo'ldi (1,33), shu jumladan formatlash (1.07). Bu erda noqulaylik sifatida qayd etilgan narsa hujjatlarni yuritishning yagona qoidalarining yo'qligi edi. Shuning uchun, "bir o'lchamli" yondashuvdan qochish uchun ular mavjud hujjat misollari asosida ishlashga majbur. Shuning uchun foydali taklif hujjat boshqaruvi standartini yaratish va uning tarkibiy qismlari uchun shablonlarni ishlab chiqishdir.

NIB ilovalari uchun hujjatlar funktsional qo'llab-quvvatlashni topshirish vaqtida yangilangan (0.73). Bu tushunarli, chunki loyihaning funktsional qo'llab-quvvatlashni taqdim etish mezonlaridan biri zamonaviy hujjatlardir. Amalga oshirishni tushunish uchun bu etarli (0.67), garchi ba'zida savollar qolmoqda.

Biroq, respondentlar NIB ilovalari uchun hujjatlar odatda faqat funktsional qo'llab-quvvatlash uchun zarur degan fikrga (bir ovozdan) rozi bo'lishmadi (-1.53). Hujjatlar iste'molchilari sifatida tahlilchilar ko'pincha tilga olindi, boshqa jamoa a'zolari (ishlab chiquvchilar) esa kamroq tilga olindi. Bundan tashqari, tahlilchilarning fikricha, ishlab chiquvchilar bir ovozdan (-0.06) bo'lmasa ham, nima amalga oshirish kerakligini tushunish uchun hujjatlardan foydalanmaydi. Bu, tasodifan, kod ishlab chiqish va hujjatlar parallel ravishda yozilgan muhitda ham kutiladi.

Xulosa nima va bu raqamlar bizga nima uchun kerak?

Hujjatlar sifatini oshirish uchun biz quyidagilarni qilishga qaror qildik:

  1. Ishlab chiquvchidan yozma hujjatlarni ko'rib chiqishni so'rang.
  2. Iloji bo'lsa, hujjatlarni o'z vaqtida yangilang, birinchi navbatda, old tomondan.
  3. NIS loyihalarini hujjatlashtirish standartini yarating va qabul qiling, shunda har bir kishi tizimning qaysi elementlari va qanday tasvirlanishi kerakligini tezda tushuna oladi. Va tegishli shablonlarni ishlab chiqing.

Bularning barchasi hujjatlar sifatini yangi bosqichga ko'tarishga yordam berishi kerak.

Hech bo'lmaganda shunday umid qilaman.

Manba: www.habr.com

DDoS himoyasi, VPS VDS serverlari bo'lgan saytlar uchun ishonchli hosting sotib oling 🔥 DDoS himoyasi, VPS VDS serverlari bilan ishonchli veb-sayt xostingini sotib oling | ProHoster