અમે કેવી રીતે દસ્તાવેજીકરણની ગુણવત્તાનું મૂલ્યાંકન કર્યું

હેલો, હેબ્ર! મારું નામ લેશા છે, હું Alfa-Bank ની પ્રોડક્ટ ટીમોમાંથી એક માટે સિસ્ટમ એનાલિસ્ટ છું. હવે હું કાનૂની સંસ્થાઓ અને વ્યક્તિગત સાહસિકો માટે એક નવી ઓનલાઈન બેંક વિકસાવી રહ્યો છું.

અને જ્યારે તમે વિશ્લેષક હોવ, ખાસ કરીને આવી ચેનલમાં, તમે દસ્તાવેજો અને તેની સાથે કામ બંધ કર્યા વિના ક્યાંય પણ મેળવી શકતા નથી. અને દસ્તાવેજીકરણ એ એવી વસ્તુ છે જે હંમેશા ઘણા પ્રશ્નો ઉભા કરે છે. વેબ એપ્લિકેશનનું વર્ણન શા માટે કરવામાં આવતું નથી? શા માટે સ્પષ્ટીકરણ સૂચવે છે કે સેવા કેવી રીતે કાર્ય કરવી જોઈએ, પરંતુ તે તેના જેવું કામ કરતું નથી? એવું શા માટે છે કે ફક્ત બે લોકો, જેમાંથી એકે તે લખ્યું છે, સ્પષ્ટીકરણ સમજી શકે છે?

જો કે, સ્પષ્ટ કારણોસર દસ્તાવેજીકરણને અવગણી શકાય નહીં. અને અમારા જીવનને સરળ બનાવવા માટે, અમે દસ્તાવેજોની ગુણવત્તાનું મૂલ્યાંકન કરવાનું નક્કી કર્યું. અમે આ કેવી રીતે કર્યું અને અમે કયા નિષ્કર્ષ પર આવ્યા તે કટની નીચે છે.

દસ્તાવેજીકરણ ગુણવત્તા

ટેક્સ્ટમાં ઘણી ડઝન વખત "નવી ઇન્ટરનેટ બેંક" નું પુનરાવર્તન ન કરવા માટે, હું NIB લખીશ. હવે અમારી પાસે એક ડઝનથી વધુ ટીમો છે જે સાહસિકો અને કાનૂની સંસ્થાઓ માટે NIBના વિકાસ પર કામ કરી રહી છે. તદુપરાંત, તેમાંના દરેક કાં તો નવી સેવા અથવા વેબ એપ્લિકેશન માટે શરૂઆતથી તેના પોતાના દસ્તાવેજો બનાવે છે, અથવા વર્તમાનમાં ફેરફાર કરે છે. આ અભિગમ સાથે, શું સૈદ્ધાંતિક રીતે દસ્તાવેજીકરણ ઉચ્ચ ગુણવત્તાનું હોઈ શકે છે?

અને દસ્તાવેજોની ગુણવત્તા નક્કી કરવા માટે, અમે ત્રણ મુખ્ય લાક્ષણિકતાઓ ઓળખી છે.

1. તે પૂર્ણ હોવું જોઈએ. આ તેના બદલે કેપ્ટન જેવું લાગે છે, પરંતુ તે નોંધવું મહત્વપૂર્ણ છે. તે અમલમાં મૂકાયેલ ઉકેલના તમામ ઘટકોનું વિગતવાર વર્ણન કરવું જોઈએ.
2. તે સુસંગત હોવું જોઈએ. એટલે કે, ઉકેલના વર્તમાન અમલીકરણને અનુરૂપ.
3. તે સમજી શકાય તેવું હોવું જોઈએ. જેથી તેનો ઉપયોગ કરનાર વ્યક્તિ સમજી શકે કે ઉકેલનો અમલ કેવી રીતે થાય છે.

સારાંશ માટે - સંપૂર્ણ, અદ્યતન અને સમજી શકાય તેવા દસ્તાવેજો.

મતદાન

દસ્તાવેજોની ગુણવત્તાનું મૂલ્યાંકન કરવા માટે, અમે તેની સાથે સીધા કામ કરનારાઓનો ઇન્ટરવ્યુ લેવાનું નક્કી કર્યું: NIB વિશ્લેષકો. ઉત્તરદાતાઓને સ્કીમ અનુસાર 10 નિવેદનોનું મૂલ્યાંકન કરવા માટે કહેવામાં આવ્યું હતું "1 થી 5 ના સ્કેલ પર (સંપૂર્ણપણે અસંમત - સંપૂર્ણ સંમત)."

નિવેદનો ગુણાત્મક દસ્તાવેજીકરણની લાક્ષણિકતાઓ અને NIB દસ્તાવેજો અંગે સર્વે કમ્પાઈલરોના અભિપ્રાયને પ્રતિબિંબિત કરે છે.

1. NIB અરજીઓ માટેના દસ્તાવેજો અદ્યતન છે અને તેમના અમલીકરણ સાથે સંપૂર્ણપણે સુસંગત છે.
2. NIB અરજીઓનો અમલ સંપૂર્ણપણે દસ્તાવેજીકૃત છે.
3. NIB એપ્લિકેશન્સ માટે દસ્તાવેજીકરણ માત્ર કાર્યાત્મક આધાર માટે જરૂરી છે.
4. NIB એપ્લીકેશન માટે દસ્તાવેજીકરણ તેમના કાર્યાત્મક સમર્થન માટે સબમિટ કરવાના સમયે વર્તમાન છે.
5. NIB એપ્લિકેશન ડેવલપર્સ તેઓને શું અમલ કરવાની જરૂર છે તે સમજવા માટે દસ્તાવેજોનો ઉપયોગ કરે છે.
6. NIB અરજીઓ કેવી રીતે અમલમાં આવે છે તે સમજવા માટે પૂરતા દસ્તાવેજો છે.
7. જો NIB પ્રોજેક્ટ્સ (મારી ટીમ દ્વારા) ફાઇનલ કરવામાં આવે તો હું તેના પરના દસ્તાવેજોને તાત્કાલિક અપડેટ કરું છું.
8. NIB એપ્લિકેશન વિકાસકર્તાઓ દસ્તાવેજીકરણની સમીક્ષા કરે છે.
9. NIB પ્રોજેક્ટ્સ માટે દસ્તાવેજીકરણ કેવી રીતે તૈયાર કરવું તેની મને સ્પષ્ટ સમજ છે.
10. હું સમજું છું કે NIB પ્રોજેક્ટ્સ માટે દસ્તાવેજીકરણ ક્યારે લખવું/અપડેટ કરવું.

તે સ્પષ્ટ છે કે ફક્ત "1 થી 5" નો જવાબ આપવાથી જરૂરી વિગતો પ્રગટ થઈ શકશે નહીં, તેથી વ્યક્તિ દરેક વસ્તુ પર ટિપ્પણી કરી શકે છે.

અમે આ બધું કોર્પોરેટ સ્લૅક દ્વારા કર્યું - અમે ફક્ત સિસ્ટમ વિશ્લેષકોને સર્વેક્ષણ કરવા માટે આમંત્રણ મોકલ્યું. ત્યાં 15 વિશ્લેષકો હતા (9 મોસ્કોથી અને 6 સેન્ટ પીટર્સબર્ગથી). સર્વેક્ષણ પૂર્ણ થયા પછી, અમે દરેક 10 સ્ટેટમેન્ટ માટે સરેરાશ સ્કોર જનરેટ કર્યો, જેને અમે પછી પ્રમાણિત કર્યો.

આવું જ થયું.

સર્વે દર્શાવે છે કે જો કે વિશ્લેષકો માને છે કે NIB અરજીઓનો અમલ સંપૂર્ણપણે દસ્તાવેજીકૃત છે, તેઓ અસ્પષ્ટ કરાર આપતા નથી (0.2). ચોક્કસ ઉદાહરણ તરીકે, તેઓએ ધ્યાન દોર્યું કે હાલના સોલ્યુશન્સમાંથી સંખ્યાબંધ ડેટાબેઝ અને કતારોને દસ્તાવેજીકરણ દ્વારા આવરી લેવામાં આવ્યાં નથી. વિકાસકર્તા વિશ્લેષકને કહેવા સક્ષમ છે કે બધું દસ્તાવેજીકૃત નથી. પરંતુ વિકાસકર્તાઓ દસ્તાવેજીકરણની સમીક્ષા કરતા થીસીસને પણ સ્પષ્ટ સમર્થન પ્રાપ્ત થયું નથી (0.33). એટલે કે, અમલમાં મૂકાયેલા ઉકેલોના અપૂર્ણ વર્ણનનું જોખમ રહે છે.

સુસંગતતા સરળ છે - જો કે ફરીથી કોઈ સ્પષ્ટ સમજૂતી નથી (0,13), વિશ્લેષકો હજુ પણ સંબંધિત દસ્તાવેજોને ધ્યાનમાં લેવા માટે વલણ ધરાવે છે. ટિપ્પણીઓએ અમને સમજવાની મંજૂરી આપી કે સુસંગતતા સાથેની સમસ્યાઓ મધ્યમાં કરતાં આગળની બાજુએ વધુ હોય છે. જો કે, તેઓએ અમને સમર્થન વિશે કંઈપણ લખ્યું નથી.

જ્યારે દસ્તાવેજો લખવા અને અપડેટ કરવા જરૂરી છે ત્યારે વિશ્લેષકો પોતે સમજે છે કે કેમ, કરાર તેની ડિઝાઇન (1,33) સહિત વધુ સમાન (1.07) હતો. અસુવિધા તરીકે અહીં જે નોંધ્યું હતું તે દસ્તાવેજો જાળવવા માટે સમાન નિયમોનો અભાવ હતો. તેથી, "કોણ જંગલમાં જાય છે, કોણ લાકડા મેળવે છે" મોડને ચાલુ ન કરવા માટે, તેઓએ હાલના દસ્તાવેજોના ઉદાહરણોના આધારે કામ કરવું પડશે. તેથી, એક ઉપયોગી ઈચ્છા એ છે કે દસ્તાવેજ વ્યવસ્થાપન માટે એક માનક બનાવવું અને તેમના ભાગો માટે નમૂનાઓ વિકસાવવી.

કાર્યાત્મક સપોર્ટ (0.73) માટે સબમિટ કરતી વખતે NIB એપ્લિકેશન્સ માટે દસ્તાવેજીકરણ વર્તમાન છે. આ સમજી શકાય તેવું છે, કારણ કે કાર્યાત્મક સમર્થન માટે પ્રોજેક્ટ સબમિટ કરવાના માપદંડોમાંનું એક અદ્યતન દસ્તાવેજીકરણ છે. તે અમલીકરણને સમજવા માટે પણ પૂરતું છે (0.67), જોકે કેટલીકવાર પ્રશ્નો રહે છે.

પરંતુ ઉત્તરદાતાઓ જેની સાથે સહમત ન હતા (તદ્દન સર્વસંમતિથી) તે એ હતું કે NIB એપ્લિકેશન્સ માટે દસ્તાવેજીકરણ, સૈદ્ધાંતિક રીતે, ફક્ત કાર્યાત્મક સમર્થન માટે જ જરૂરી છે (-1.53). વિશ્લેષકોનો ઉલ્લેખ મોટાભાગે દસ્તાવેજોના ઉપભોક્તા તરીકે થતો હતો. બાકીની ટીમ (વિકાસકર્તાઓ) - ઘણી ઓછી વાર. તદુપરાંત, વિશ્લેષકો માને છે કે વિકાસકર્તાઓ તેમને અમલમાં મૂકવાની જરૂર છે તે સમજવા માટે દસ્તાવેજોનો ઉપયોગ કરતા નથી, જોકે સર્વસંમતિથી (-0.06) નથી. આ, માર્ગ દ્વારા, એવી પરિસ્થિતિઓમાં પણ અપેક્ષિત છે જ્યાં કોડ વિકાસ અને દસ્તાવેજીકરણ લેખન સમાંતર રીતે આગળ વધે છે.

બોટમ લાઇન શું છે અને આપણને આ નંબરોની શા માટે જરૂર છે?

દસ્તાવેજોની ગુણવત્તા સુધારવા માટે, અમે નીચે મુજબ કરવાનું નક્કી કર્યું:

1. વિકાસકર્તાને લેખિત દસ્તાવેજોની સમીક્ષા કરવા કહો.
2. જો શક્ય હોય તો, સમયસર દસ્તાવેજીકરણ અપડેટ કરો, પહેલા આગળ.
3. NIB પ્રોજેક્ટ્સનું દસ્તાવેજીકરણ કરવા માટે એક માનક બનાવો અને અપનાવો જેથી દરેક વ્યક્તિ ઝડપથી સમજી શકે કે સિસ્ટમના કયા તત્વો અને કેવી રીતે બરાબર વર્ણન કરવું જોઈએ. સારું, યોગ્ય નમૂનાઓ વિકસાવો.

આ તમામ દસ્તાવેજોની ગુણવત્તાને નવા સ્તરે વધારવામાં મદદ કરશે.

ઓછામાં ઓછું હું એવી આશા રાખું છું.

સોર્સ: www.habr.com