Пасивни глас врти се око конвенционалне реченице. Она помера глагол и усмерава предмет према првој половини реченице, а главни тему поставља у другу половину реченице. Често једноставно реструктурирање реченице чини је активном.
`ПАСИВАН: Лична сигурност се унапређује избором јаке лозинке.`
#### Контекст
Избегавајте писање ван контекста.
Пажљиво се придржавајте теме документа, поглавља, одељка и става.
Користите референце, према потреби, структурирајући докуменат тако да се сваки нови део надограђује на претходни.
Избегавајте да читалац прескаче унапред да би тренутне делове ставио у контекст.
Наведите везу до сродне документације ако ће је читаоцу можда требати ради појашњења.
#### Наглашавање
Наглашавање је најефикасније када се употребљава умерено.
Користите методе нагласка као што су подебљање, подвлачење или коси текст да бисте скренули пажњу на нови појам.
Употребите напомене да бисте нагласили битан материјал.
Још један прихватљив начин да се истакне тачка је различито формирање реченица или избор речи.
Најбољи писци документације планирају унапред нагласак, примјењујући гаса пажњом у доследно са документом.
#### Прецизност и Тачност
Прецизност и тачност праве или кваре било који документ.
Овај аксиом се подједнако односи на техничку и књижевну тачност.
Изаберите речи након што размотрите што је више могуће случајева. На пример, „иди на“ није тако прецизно као „кликни“, али „кликни“ можда није тачно за све интеракције интерфејса. Израз "изабери" је тачан у сваком случају употребе и довољно прецизан.
Не будите преокупирани покушајем да покријете све могуће случајеве употребе. Покривање ретких споредних случајева продужава документ без разлога, а читалац губи фокус.
Добри писци морају погодити баланс између преише понављање именичних фраза, и коришћење заменица које замењују именице. Опште правило за очување јасноће је да никада не треба понављати замену именице са заменицом у две узастопне реченице.
Читаоци техничке документације требају стално подсећање на праву тему о којој аутор пише. Претерано коришћење заменица може узроковати да читаоци погађају тему на коју реченица упућује.
Повремено ситуације захтевају другу личну заменицу "ви" и њене пратеће форме због јасноће.
Одржавање активног гласа је најважније преко избегавање других личних заменица. "Ви" и "ваше" су одговарајуће речи које означавају радњу или поседовање са стране читаоца.
Неодређене заменице попут "ово" или "оно" без члана испред чине читаоцу тешко да следи смисао аутора.
Фаворизујте писање прецизне именичог изразакад год је то могуће уместо нејасних речи попут „ово“, „ови“, „оно“ и „то“.
`НЕИСПРАВНО: Уредите ваш yum конфигурационе фајлове да би користити географски најближе мироре. Ово вам омогућава да брже надоградите свој систем.`
`ИСПРАВНО: Уредите yum конфигурационе фајлове да би користили географски најближе мироре за бржу надградњу система.`
Када елиминишете неодређене заменице, гломазна дуга реченица може бити резултат придруживања превише чланова.
Употребите неодређене заменице да бисте раздвојили дуге реченице ради побољшања јасноћe, али увек осигурајте одговарајући претходни члан.
Многе речи које користимо у свакодневној конверзацији умањују утицај штампаних материјала зато што "остављају излаз напоље".
Ово су речи које стоје испред глагола и именица ради умањења значаја реченице. Ово није преобина листа, али пажљиви писци документације ће умањити коришћење тих речи и других сличне природе.
#### Избегавајте умањивање значаја са непотребним речима
Следеће ечи умањују значај склоп глагола или именице у реченици.
Друге речи такође могу упасти у ову категорију, али ова кратка листа има за циљ да помогне писцу документације да утврди речи ове природе и уклони их из свог писања: ** треба, може, може бити, могуће, можда, неки, многи, већина, бројни, неколико, понешто, донекле, шта год, по могућности, може повремено и често**.
За највећи значај, задржите прву и последњу реченицу у параграфу што је краћом могуће.
Мењањем дужине реченице у параграфу и кроз цео документ држи пажњу читаоца. Кратка и једноставна чињеница се лако прихвата и користи за анализу теме следеће реченице. Не постији ништа погрешно у коришћењу дуже реченице ради објашњења сложене идеје или концепта. Покушајте да користите једноставне реченице на крају сваког параграфа да би читаоу дали могућност да обухвати све битне информације.
Кратка последња реченица остаје са читаоцем за следећу секцију.
Лоше постављен, зарез, тачка зарез или неправилно коришћење знакова интерпукције може потпуно променити значење реченице. Интерпукцијске ознаке су затварачи у пишчевом алату. Читаоци су навикнути на уобичајене ознаке, попут зареза или три тачке, а мање познате ознаке лако скрећу пажњу читаоцима.
Сложене интерпукцијске ознаке нису универзалне, и отежавају напоре за превођење OpenMandriva документације.
Смањите употребу следећих интерпукцијских ознака у документацији:
* Заграде или црте
Ради замене, промените редослед реченице, или је раздвојите у две целине
* Тачка зарез
Она је добра само уколико су две мисли повезане, морају бити сједињене ради јасноће, а уклањају потребу за спајањем.
* Двотачка
Уколико постоје више од три појма, треба користити листу ради лакшег разумевања
* три тачке
Немојте их користити због стилског наглашавања... само ради обавештавања о непрекидном настављању садржаја у примеру
* Наводници
У техничком писању они су прихватљиви само за коришћење последње решење за навођење "упозорења", не за наглашавање
* Знак &
Реч "и" треба написати, а овај знак користити само уколико је део рачунарске команде
Немојте користити косе црте за скраћивање попут "он или она" коришћењем он/она уместо речи "и", "или" или "ни". Косе црте се често користе у путањама фајлова и њихово коришћење у друге сврхе може направити конфузију
Сваки писац наиђе на препреке у писању. Постаје тешко адекватно формулисати нешто или речи једноставно не звуче исправно.
Због тога је Опенмандрива пројекат тимски напор. Позовите колеге писце документације на листи за слање или цхат соби за помоћ у вези са формулацијама и проблемима у формату.
Још један трик који професионални писци користе свакодневно је време далеко од пројекта. Одмакните се од документа. Повратак на проблематично место свјежим очима често је све што је потребно за превазилажење препрека писања.
Општи циљ документационог пројекта OpenMandriva је пружање помоћи корисницима ОpenMandriva на лако разумљивом језику.
Не морате писати да бисте импресионирали професора енглеског језика или показали своју стручност у вези са неком темом. Кратке реченице, честе дефиниције нових и непознатих термина, као и референтне везе, су помоћ која наша публика највише цени.
Пишите имајући на уму циљану публику, и то ће бити ваши доприноси у документацији са највећим бројем посета корисника којима је потребан одговор.
