IDÉZET(VINIKOR @ 2005. november 07., 16:54 - hétfő)
Program leírásánál nem hiszem, hogy meg kell ütni magas szintű irodalmi nyelvet. Lehetne egy rövid szabályzatban rögzíteni, hogy milyen fórmátumban kell megírni a programhasználati leírásokat.
Pl:
Programnév.
1. X müvelet:
a gomb --> b gomb --> c gomb...stb stb
2. Z müvelet:
a gomb --> b gomb --> c gomb...stb stb
..és ennyi! Végülis nem az lenne a cél, hogy ki tud minél szellemesebb körmondatokban és eröltetten lazáskodó stílusban leírni egy programhasználatot,
De fontos hogy hogyan írod! Ugyanis persze, nem az irodalmi stílus a cél, hanem a jól átgondolt sorrendben megfogalmazott ÉRTHETŐ mondatok leírása. Az adott hardver/szoftver az irás nyomán keltse fel az érdeklődésem, legyen részletes, de ne legyen ez túlzott. részletességű sem. Fontos, hogy olyan embereknek írod a bemutatót, akik még a szoftvert nem használták, vagy a bemutatandó hardverről semmit sem tudnak. Mindenképpen le kell adott esetben írni olyan dolgot is, ami Neked magától értetődő, de egy, a szoftverrel, vagy hardverrel most ismerkedőnek nem.
Pl. Timernek nagyon jó írásai vannak a weboldalán. Nála a szövegtördeléssel vannak bajok, de ez legyen a legnagyobb hiba, úgysem Ő tenné ki a PCW weboldalára.

Szintén el lehet néhány írást olvasni az én weboldalamon is a programleírásoknál. Figyelni kell(ene) arra, amire már annyiszor felhívtam a figyelmet a fórumon belül is, hogy nem "menőzve", azaz agyon szlengelve, és rövidítve kell írni. Erre "jó" példa, hogy hogyan ne írj, Nemvicces honlapja. (http://nemvicces.atw.hu)
Tehát a fogalmazás készség, és a magyar nyelv ismerete elengedhetetlen. A szomorú az, hogy ennek nem feltételnek kellene lennie, hanem alapvető, magától értetődő dolognak, amit minden általános iskolában tanítanak.
Fontos, amikor írsz, hogy olvasd el többször: Leírtál e mindent, nem e túl "csapongó" az írás, tehát ne ugrálj például szoftverfunkciók között, mert nem lesz követhető az írásod, és nem fogják az olvasóid tudni, mit szeretnél nekik elmondani.
Mindenképpen kell egy váz, ami alapján haladsz. Lévén, nem újságcikket kell írni, hanem pl. szoftver bemutatót, így fel kell építeni egy menetrendet, azaz hogy hogyan fogod a szoftver egyes funkcióit bemutatni: mi az amiről részletesebben kell írni (pl. egy CD/DVD író szoftver írási modulja) és mi az, amiről csak emlitésszinten érdemes szót ejtetni. (Pl. skinezhetőség)
Fontos, hogy lehetőleg kerülni kell a felesleges szóhasználatot, szóismétlést. Ha átolvasod az irásod, és túl sokszor szerepel benne a "program" vagy a "szoftver" szó, bugyutának tünhet az írásod.
Tehát, mint látható, nem az irodalmi érzék az, ami egy program bemutatásához, finkcióinak leírásához szükségeltetik.