3.1 Üldnõuded Dokumentatsioonile¶

Käesolev peatükk keskendub elektripaigaldise ehitusprojekti dokumentatsiooni koostamisele, struktureerimisele ja vormistamisele. Kvaliteetne, selge ja ühtne dokumentatsioon on eduka projekti elluviimise, ehitushanke, ehitustööde teostamise ja hilisema käidu ning hoolduse aluseks.

3.1. Üldnõuded Dokumentatsioonile¶

See alajaotis kirjeldab üldiseid põhimõtteid ja nõudeid, mis kehtivad kogu elektripaigaldise projektdokumentatsioonile (sh seletuskirjad, joonised, skeemid, loetelud, arvutused jne), sõltumata konkreetsest dokumendi tüübist või projekti staadiumist. Detailsemad nõuded spetsiifilistele dokumenditüüpidele ja vormistuselementidele on esitatud järgnevates alajaotistes (3.2 kuni 3.7).

3.1.1. Dokumentatsiooni Terviklikkus ja Järjepidevus¶

Terviklikkus: Kogu ehitusprojekt koos kõigi selle osade ja dokumentidega moodustab ühtse terviku. Erinevad dokumendid täiendavad üksteist ning neid tuleb käsitleda ja kasutada koos.
Järjepidevus: Informatsioon, mis on esitatud ühes projekti dokumendis (nt seletuskirjas), peab olema kooskõlas teistes dokumentides (nt joonistel, skeemidel, loeteludes) esitatud infoga. Vastuolusid tuleb vältida.
Vastuolude Lahendamine: Kuigi vastuolusid tuleb vältida, siis nende esinemisel sama staadiumi dokumentide vahel lähtutakse üldjuhul määruses "Nõuded ehitusprojektile" §6(2) toodud hierarhiast: esmalt seletuskiri, seejärel joonised, siis muud dokumendid. Tööprojekti staadiumis, kui kogu info on joonistel, võib joonistel esitatu olla ülimuslik. Käesolev juhend soovitab siiski tagada info vastuoludeta esituse kõikides dokumentides.
Viitamine: Dokumentide vahel tuleb kasutada selgeid ja korrektseid ristviiteid, et tagada info leitavus ja seosed erinevate dokumentide vahel (nt seletuskirjas viide konkreetsele joonisele/skeemile).

3.1.2. Selgus ja Loetavus¶

Arusaadavus: Projektdokumentatsioon peab olema koostatud nii, et see on erialaspetsialistile (projekteerija, ehitaja, järelvalve teostaja, haldaja) lihtsalt loetav, üheselt mõistetav ja ilma vastuoludeta.
Struktuur ja Ülesehitus: Informatsioon peab olema esitatud loogiliselt struktureeritult. Dokumentide (eriti seletuskirjade ja jooniste) ülesehitus peaks olema selge ja järjepidev.
Detailsus: Esitatud info detailsusaste peab vastama konkreetsele projekti staadiumile (EP, PP, TP) vastavalt käesoleva juhendi peatükis 2.1 ja EVS 932:2017 nõuetele. Vältida tuleb nii ebapiisavat kui ka ülemäärast detailsust.
Graafiline Selgus: Joonised ja skeemid peavad olema graafiliselt selged, vältides elementide ülekuhjumist ja kasutades piisavalt suurt kirja ning eristatavaid tingmärke.
Failide Optimeerimine: Digitaalsed dokumendid (eriti PDF-failid) peavad olema tehniliselt korrektsed ja optimeeritud mahuga, et tagada nende mugav kasutamine.

3.1.3. Keel ja Terminoloogia¶

Keel: Projektdokumentatsiooni keel on eesti keel. Tuleb kasutada korrektset grammatikat, lauseehitust ja erialast stiili, vältides liigseid võõrkeelseid termineid või slängi.
Terminoloogia: Kogu projektis tuleb kasutada ühtset ja korrektset erialast terminoloogiat. Lähtuda tuleb käesoleva juhendi peatükis 1.3 defineeritud terminitest ning asjakohastest standarditest. Ebaselguse või mitmetitõlgendatavuse vältimiseks tuleb vajadusel termineid seletuskirjas täiendavalt defineerida.

3.1.4. Vormistuslik Ühtsus¶

Kogu projekti dokumentatsioon peab olema vormistatud ühtses stiilis. See hõlmab lehekülgede paigutust, kirjatüüpe ja -suurusi, joonte stiile, tingmärke, kirjanurkade ja tiitellehtede kasutamist.
Detailsemad nõuded vormistuselementidele (digitaalne vorming, failinimed, tiitellehed, seletuskiri, joonised, skeemid, spetsifikatsioonid, arvutused) on esitatud käesoleva peatüki järgnevates alajaotistes (3.2 kuni 3.7). Nende järgimine tagab projektide võrreldavuse ja professionaalse väljanägemise.

3.1.5. Muudatuste Haldamine¶

Projekteerimisprotsess on iteratiivne ja muudatused on sageli vältimatud. Kõik pärast dokumendi esmast väljastamist või kooskõlastamist tehtud muudatused tuleb korrektselt hallata ja dokumenteerida vastavalt määruse "Nõuded ehitusprojektile" §12 nõuetele.
Märgistamine: Muudatused tuleb joonistel ja muudes dokumentides selgelt märgistada (nt revisjonipilvedega, muudatuste tabelis kirjanurgas).
Versioonihaldus: Iga muudetud dokument peab saama uue versiooninumbri ja muutmise kuupäeva.
Dokumentide Nimekiri: Projekti dokumentide nimekiri peab alati kajastama kehtivate dokumentide staatust, sh viimaseid versioone ja muudatuste kuupäevi.
Kooskõlastamine: Olulised muudatused tuleb kooskõlastada tellija ja teiste asjassepuutuvate osapooltega.