Hujjatlarning sifatini qanday baholadik

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

Va siz tahlilchi bo'lganingizda, ayniqsa, bunday kanalda, hujjatsiz va u bilan yaqindan ishlamasdan hech qaerga borolmaysiz. Hujjatlar esa har doim ko'p savollar tug'diradigan narsadir. Nima uchun veb-ilova tasvirlanmagan? Nima uchun spetsifikatsiyada xizmat qanday ishlashi kerakligi ko'rsatilgan, lekin u umuman bunday ishlamaydi? Nima uchun faqat ikkita odam, ulardan biri yozgan, spetsifikatsiyani tushuna oladi?

Biroq, aniq sabablarga ko'ra hujjatlarni e'tiborsiz qoldirib bo'lmaydi. Va hayotimizni osonlashtirish uchun biz hujjatlar sifatini baholashga qaror qildik. Biz buni qanday qilib aniq qildik va qanday xulosalarga keldik, kesma ostida.

Hujjat sifati

Matnda "Yangi Internet Bank" ni bir necha o'nlab marta takrorlamaslik uchun men NIB yozaman. Hozir bizda tadbirkorlar va yuridik shaxslar uchun NIBni ishlab chiqish bo'yicha o'ndan ortiq jamoalar ishlamoqda. Bundan tashqari, ularning har biri noldan yangi xizmat yoki veb-ilova uchun o'z hujjatlarini yaratadi yoki joriyiga o'zgartirishlar kiritadi. Ushbu yondashuv bilan hujjatlar printsipial jihatdan yuqori sifatli bo'lishi mumkinmi?

Va hujjatlar sifatini aniqlash uchun biz uchta asosiy xususiyatni aniqladik.

1. To'liq bo'lishi kerak. Bu kapitanga o'xshaydi, lekin shuni ta'kidlash kerak. U amalga oshirilgan yechimning barcha elementlarini batafsil tavsiflashi kerak.
2. U joriy bo'lishi kerak. Ya'ni, yechimning o'zi joriy amalga oshirilishiga mos keladi.
3. Bu tushunarli bo'lishi kerak. Shunday qilib, uni ishlatadigan odam yechim qanday amalga oshirilishini aniq tushunadi.

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

So'rov

Hujjatlarning sifatini baholash uchun biz u bilan bevosita ishlaydiganlar: NIB tahlilchilari bilan suhbatlashishga qaror qildik. Respondentlardan 10 ta bayonotni "1 dan 5 gacha bo'lgan shkala bo'yicha (butunlay qo'shilmayman - to'liq roziman)" sxemasi bo'yicha baholash so'ralgan.

Bayonotlarda sifatli hujjatlarning xususiyatlari va so'rovni tuzuvchilarning NIB hujjatlariga nisbatan fikrlari aks ettirilgan.

1. NIB ilovalari uchun hujjatlar yangilangan va ularni amalga oshirish bilan 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 qanday amalga oshirilishini tushunish uchun etarli hujjatlar mavjud.
7. NIB loyihalari bo'yicha hujjatlarni zudlik bilan yangilayman, agar ular yakunlangan bo'lsa (mening jamoam tomonidan).
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 ma'lumotlarni ochib bermasligi aniq, shuning uchun odam har bir elementga sharh qoldirishi mumkin.

Biz bularning barchasini korporativ Slack orqali amalga oshirdik – biz shunchaki tizim tahlilchilariga so‘rovnoma o‘tkazish uchun taklif yubordik. 15 nafar tahlilchi (9 nafari Moskvadan, 6 nafari Sankt-Peterburgdan) edi. So'rov tugallangandan so'ng, biz 10 ta bayonotning har biri uchun o'rtacha ball yaratdik, keyin uni standartlashtirdik.

Bu shunday bo'ldi.

So'rov shuni ko'rsatdiki, tahlilchilar NIB arizalarini amalga oshirish to'liq hujjatlashtirilganligiga ishonishga moyil bo'lsalar ham, ular aniq rozilik bermaydilar (0.2). Muayyan misol sifatida ular bir qator ma'lumotlar bazalari va mavjud echimlardan navbatlar hujjatlar bilan qamrab olinmaganligini ta'kidladilar. Ishlab chiquvchi tahlilchiga hamma narsa hujjatlashtirilmaganligini aytishga qodir. Ammo ishlab chiquvchilar hujjatlarni ko'rib chiqadigan tezis ham aniq qo'llab-quvvatlanmadi (0.33). Ya'ni, amalga oshirilgan echimlarning to'liq tavsiflanmaganligi xavfi saqlanib qolmoqda.

Muvofiqlik osonroq - garchi yana aniq kelishuv bo'lmasa ham (0,13), tahlilchilar hujjatlarni tegishli deb hisoblashga moyil. Sharhlar bizga dolzarblik bilan bog'liq muammolar o'rtadan ko'ra ko'proq old tomonda ekanligini tushunishga imkon berdi. Biroq, ular bizga qo'llab-quvvatlash haqida hech narsa yozmadilar.

Hujjatlarni yozish va yangilash zarurligini tahlilchilarning o'zlari tushunadimi yoki yo'qmi, kelishuv ancha bir xil (1,33), shu jumladan uning dizayni (1.07) edi. Bu erda noqulaylik sifatida qayd etilgan narsa hujjatlarni yuritishning yagona qoidalarining yo'qligi edi. Shuning uchun, "O'rmonga kim boradi, o'tin oladi" rejimini yoqmaslik uchun ular mavjud hujjatlar misollari asosida ishlashlari kerak. Demak, foydali istak - hujjatlarni boshqarish uchun standart yaratish va ularning qismlari uchun shablonlarni ishlab chiqish.

NIB ilovalari uchun hujjatlar funktsional qo'llab-quvvatlash uchun topshirish vaqtida mavjud (0.73). Bu tushunarli, chunki loyihani funktsional qo'llab-quvvatlash uchun taqdim etish mezonlaridan biri bu dolzarb hujjatlardir. Amalga oshirishni tushunish ham etarli (0.67), garchi ba'zida savollar qolmoqda.

Ammo respondentlar rozi bo'lmagan narsa (bir ovozdan) NIB ilovalari uchun hujjatlar, asosan, faqat funktsional qo'llab-quvvatlash uchun kerak (-1.53). Hujjatlarni iste'mol qiluvchilar sifatida tahlilchilar ko'pincha tilga olinadi. Jamoaning qolgan qismi (ishlab chiquvchilar) - kamroq. Bundan tashqari, tahlilchilarning fikricha, ishlab chiquvchilar bir ovozdan (-0.06) bo'lmasa-da, nima qilish kerakligini tushunish uchun hujjatlardan foydalanmaydilar. Aytgancha, bu kodni ishlab chiqish va hujjatlarni yozish parallel ravishda davom etadigan sharoitlarda 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, avval hujjatlarni o'z vaqtida yangilang.
3. NIB loyihalarini hujjatlashtirish standartini yarating va qabul qiling, shunda har bir kishi tizimning qaysi elementlari va qanday aniq tasvirlanishi kerakligini tezda tushuna oladi. Xo'sh, 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