Szabványosítás a szoftver dokumentáció területén, az információs szolgáltatás igazgatója,

ARUBA INSTANT WI-FI: EGYSZERŰ, KIADHATÓ, ELÉRHETŐ

mit továbbít a felhasználóknak, és mi - a kísérőszolgálatnak? hogyan kell kezelni az egész folyamatot?

Ezen problémák mellett vannak olyanok is, amelyek például a programozás tényleges feladatai közé tartoznak?

Ezeket és sok más kérdést egyszerre választották meg a szoftverdokumentáció állami szabványai - a 19-es GOST ESDP szabványainak egy csoportja. De még akkor is, a programozóknak sok követelése volt ezeknek a szabványoknak. Valamit sokszor meg kell duplázni a dokumentációban (mivel úgy tűnt, hogy nem indokolt), de sokat nem nyújtottak be, például az integrált adatbázisokkal dolgozó programok dokumentálásának sajátosságait.

Sok év telt el, a programozás teljesen új technológiák környezetében zajlik, sok programozó, akik a drag-and-drop stílusban dolgoznak, évek óta nem látják programjaik szövegét. Ez nem jelenti azt, hogy eltűnt a dokumentálási igény. Ráadásul a szoftverek létrehozásának ezen oldalát szabályozó bármely rendszer elérhetőségével kapcsolatos kérdéseket továbbra is folyamatosan kérdezik. Azt is megkérdezik, vannak-e olyan szabványok, amelyek kötelezőek az alkalmazáshoz (ez különösen akut, ha a fejlesztést állami szervezet vagy vállalkozás kérésére végzik). Arra is kíváncsiak, hogy hol lehet megvásárolni az elérhető szabványokat.

Megpróbálunk választ adni ezekre a kérdésekre, és meg fogjuk adni az elképzelésünket arról, hogy helyénvaló a meglévő szabványok felhasználása és egy szabványrendszer kidolgozása. Csak a PS dokumentálásának normáiról beszélünk, nem érinti az automatizált rendszerek fejlesztésére vonatkozó szabványokat általánosságban, vagy konkrétabb szabványokat, például a programozási nyelvek szabványosítását.

Az állam általános jellemzői

A nemzeti szabályozási keret alapja a PS dokumentálásának területén az Unified System of Program Documentation (EDMS) standardjai. A rendszer fő és legnagyobb része a 70-es és 80-as években alakult ki. Most ez a komplexum az Orosz Föderáció területén működő FÁK-országok (GOST) államközi szabványainak rendszere egy államközi szabványosítási megállapodás alapján.

Az ECSD szabványai elsősorban az MS fejlesztése során keletkezett dokumentáció azon részét foglalják magukban, amely elsősorban az MS funkcionális jellemzőinek dokumentálására vonatkozik.

Meg kell jegyezni, hogy az ECDD szabványok ajánló jellegűek. Ez azonban érvényes a PS minden egyéb szabványára. Az a tény, hogy a szabványosításról szóló RF törvény értelmében ezek a szabványok szerződéses alapon kötelezővé válnak - vagyis, amikor a PS fejlesztéséről (beszállításáról) szóló szerződésben szerepelnek.

Az EDTS egészének állapotáról szólva megállapítható, hogy az ECSD legtöbb szabványa erkölcsileg elavult.

Az ECTS legfőbb hátrányai között szerepel:

• orientálódás a PS egyetlen "kaszkádos" életciklus modelljéhez (LC);
• nincs egyértelmű ajánlás a PS minőségi jellemzőinek dokumentálására;
• a rendszerhez való kapcsolódás hiánya a meglévő hazai szabványrendszerekkel az LC-hez és általában a termékek dokumentációjához, például az SRPP és az ESKD esetében;
• a PS mint árucikk dokumentációjának nem egyértelmű megközelítése;
• ajánlás hiánya a PS önadagolására, például képernyőmenük és operatív segítség a felhasználó számára ("segítség");
• az ígéretes dokumentumok összetételéről, tartalmáról és végrehajtásáról szóló ajánlások hiánya a PS-ben, összhangban a nemzetközi és regionális előírásokkal.

Tehát az ECTS-nek teljes körű felülvizsgálatra van szüksége az ISO / IEC 12207-95 alapján a PS életciklus-folyamatairól.

Mindazonáltal az egész komplexum felülvizsgálatát megelőzően sok szabvány felhasználható a PS dokumentálásának gyakorlatában. Ez a pozíció a következőkön alapul:

Ebben a stílusban a szabványok alkalmazását az lehet az állami általános stílus adaptációja standardokat a pontos részletek a projekt: az ügyfél és a projekt vezetője van kiválasztva a megfelelő a projekt egy részét a szabványok és a PD komplement kiválasztott PD kell osztani, és kizárják a felesleges, kötve létrehozása ezeket a dokumentumokat az áramkör LC, amelyet használnak projektben.

Meg kell mondani, hogy együtt a komplex ESPD hatósági előírások az orosz bázis a régióban a dokumentum és a kapcsolódó területeken számos olyan jövőbeni szabványok (nemzeti, transznacionális és nemzetközi szinten), a szerkezetét és tartalmát, amely a későbbiekben ismertetjük.

Az ESD szabványainak rövid bemutatása

Mind a 28 ECD szabvány közül mindössze azokra összpontosítunk, amelyek gyakrabban használhatók a gyakorlatban. Még egy, sokkal több "frisset" fogunk kiírni, mint a többieket, amelyet a modern nemzetközi normákkal való összeegyeztethetőség jellemez.

Először egy olyan szabványt jelezünk, amely a programozási feladatok kialakításában használható.

GOST 19.201-78. A feladatmeghatározás. A tartalom és a tervezés követelménye. Emlékezzünk vissza, hogy a feladatmeghatározás (TOR) egy MS követelményrendszert tartalmaz, és a kidolgozott program ellenőrzésére és elfogadásának kritériumaként használható fel. Ezért a TK, amely megfelelően össze van állítva (figyelembe véve a további szakaszok hozzáadásának lehetőségét), és amelyet az ügyfél és a fejlesztő elfogad, a PS projekt egyik alapdokumentuma.

Az alábbi szabvány az eredő fejlesztő termék dokumentálására szolgál: GOST 19.402-78 ESDP. A program leírása.

Két megjegyzést teszünk.

1. Annak ellenére, hogy nem minden, de csak a komplexum egyedi standardjai, az általuk használt terminológia, a jelölési módszerek és más részletek szükségessé tehetik az olyan közös normák támogatását, mint az ECTS GOST 19.101-77. A programok és programdokumentumok típusai és mások.
2. A dokumentum "A program leírása" dokumentum tartalmát kiegészítheti az egyéb leíró jellegű dokumentumok és iránymutatások szabványaiból származó szakaszok és elemek: az ETS GOST 19.404-79. Magyarázó megjegyzés: az ETSD 19.502-78. A leírás leírása, GOST 19.503-79. A rendszer programozó kézikönyv, GOST 19.504-79 ЕСПД. A programozó útmutatója, GOST 19.505-79 ESDP. Üzemeltetői kézikönyv.

Vannak olyan szabványcsoportok is, amelyek meghatározzák a PS átvitelére kiadott programok és PD-k egész sorát. Ők (lásd az oldalsávot) tömör könyvelési dokumentumokat hoznak létre, és hasznosak lehetnek a programok és PD-k teljes gazdaságosságának megrendeléséhez (végül is egyszerűen egyszerű elrendelést kell bevezetni!). Vannak olyan szabványok is, amelyek meghatározzák a dokumentumoknak a PS "háztartásában" tárolt szabályait.

Szintén meg kell különböztetni a GOST 19.301-79 ESDP-t. A program és a vizsgálati módszertan, amely (adaptált formában) felhasználható tervdokumentumok kidolgozására és vizsgálati munkák elvégzésére a PS felkészültségének és minőségének felmérésére.

Végül kiemelje a szabvány elfogadásának utolsó évét. Ez a GOST 19.701-90 ESDP. Az algoritmusok, programok, adatok és rendszerek rendszerei. A szimbólumok feltételes grafikai és végrehajtási szabályok. Szabályokat állapít meg a különböző típusú adatfeldolgozási feladatok és megoldásaik megjelenítésére használt rendszerek teljesítésére és teljes mértékben megfelel az ISO 5807: 1985 szabványnak.

Egyéb államközi szabványokról

Az ECTS mellett két további szabvány is érvényben van az államközi szinten, amely a PS dokumentációjához is kapcsolódik, és nem is olyan régen, mint az ESDD GOST legtöbbje.

GOST 19781-90 Információfeldolgozó szoftver nyújtása. Feltételek és definíciók. Úgy tervezték, hogy cserélje GOST 19781-83 és GOST 19,004-80 és megállapítja azokat a feltételeket és meghatározásokat a szoftverek területén (szoftver) adatfeldolgozó rendszerek (SOD), használják mindenféle dokumentáció és irodalom körébe tartozó, a szabványosítás és az eredmények e tanulmányok .

Információfeldolgozó rendszerek. Mágneses adathordozókra vonatkozó dokumentumok. A végrehajtás és a kezelés sorrendje. Nemcsak a szoftverekre terjed ki, hanem a mágneses adathordozón végzett tervezési, technológiai és egyéb projektdokumentumokra is.

Az Orosz Föderáció állami szabványai (GOST R)

GOST R ISO 9127-94 Információs rendszerek. Felhasználói dokumentáció és csomagolási információk a fogyasztói szoftvercsomagokhoz. A szabvány teljes mértékben megfelel az ISO 9127: 1989 nemzetközi szabványnak. Ennek a szabványnak a keretében a fogyasztói szoftvercsomagot (PP) úgy kell érteni, hogy "bizonyos termékek elvégzésére tervezett és értékesített szoftvereket; programot és az ehhez kapcsolódó dokumentációt, amelyet egészében csomagolva értékesítenek. " A felhasználói dokumentáció olyan dokumentáció, amelyet a végfelhasználó a PP telepítésével és működtetésével kapcsolatos információkat szolgáltat. A csomagolásra vonatkozó információ a PP külső csomagolásán reprodukált információ. Célja, hogy a potenciális vásárlókat a PP-vel kapcsolatos kezdeti információkkal látja el.

GOST R ISO / IEC 8631-94 Informatika. Szoftver konstrukciók és szimbólumok megjelenítéséhez. Leírja az eljárási algoritmusok ábrázolását.

Hogyan haladjunk előre

Amint már említettük, még nincs jobb, akkor is kihasználhatjuk azokat az ECDD szabványokat, amelyeket 20 évvel ezelőtt fogadtak el. De mindenesetre világos, hogy a modern szabványokra kell összpontosítani.

A gyakorlók egy újabb módszert használnak: maguk a projektjeikben lefordítják és felhasználják a számítógép LC-jének és dokumentációjának megszervezésére vonatkozó korszerű szabványokat. De így legalábbis hátrányban van, hogy a különböző fejlesztők és ügyfelek által készített különböző fordítások és alkalmazkodási előírások sok részletben különböznek egymástól. Ezek a különbségek elkerülhetetlenül nemcsak a neveket, hanem az értelmes definíciókat is érintik, amelyeket a szabványok bevezetnek és használnak. Így ezen az úton az összetévesztés állandó előfordulása elkerülhetetlen, és ez közvetlenül ellentétben áll a nem csak a normák céljaival, hanem bármilyen alkalmas módszertani dokumentummal is.

Összegezve, mondjuk, hogy sürgősen be kell vezetni a PS dokumentációjára vonatkozó hazai szabványokat a nemzetközi és a fejlett külföldi szinteken kialakított normákra, szabályokra, követelményekre és ajánlásokra. De ezeknek a munkáknak a végrehajtása során nem szabad korlátozni bizonyos nemzetközi szabványok közvetlen fordítását. Szükséges, hogy az új szabványok megfelelően illeszkedjenek a rendelkezésre álló és jövőbeni normatív dokumentumokhoz.

Alapvető dokumentumok

Szabványok a programgazdaságban való rendezéshez

GOST 19.202-78 ETSD. leírás
GOST 19.401-78. A program szövege
Az ETSD GOST 19.403-79. Az eredeti tulajdonosok listája
ГОСТ 19.501-78 ЕСПД. forma
GOST 19.507-79 az ETSD. Nyilatkozat a működési dokumentumokról

A menedzser új szabványai:

GOST R ISO / IEC 9294-93. Informatika. Útmutató a szoftver dokumentációjának kezeléséhez
GOST R ISO / IEC 9126-93. Informatika. A szoftver termékek értékelése. Minőségi jellemzők és iránymutatások az alkalmazásukhoz
GOST R ISO / IEC 9127-94. Információfeldolgozó rendszerek. Felhasználói dokumentáció és csomagolási információk a fogyasztói szoftvercsomagokhoz

Hivatkozási információk

IPK "Szabványügyi Kiadó". Az NTD forgalmazási területe (Store "Standards"), 17961, Moszkva, ul. Donskaya, 8, tel. 236-50-34, 237-00-02, fax / tel. 236-34-48 (részben GOST és GOST R).

VNIIKI Gosstandart oroszország (olvasóterem). 103001, Moszkva, Granatny per. 4, tel. 290-50-94 (a nemzetközi, külföldi szabványok és más NTD-k részeként).

Ossza meg az anyagot kollégákkal és barátokkal