Vorige aflevering | Search TidBITS | TidBITS Homepage | Volgende aflevering

TidBITS#428/04-Mei-98

Worm alarm! Mis deze week niet de beschouwing van Autostart-9805, een datavernietigende worm om voor uit te kijken. Verder bekijkt Adam de armzalige staat van de softwaredocumentatie en doet hij suggesties voor verbeteringen. Daarnaast hebben we een update van Eudora-internet-mailserver, het nieuwe akkoord tussen Apple en HP over Mac-printers, Dantz's Retrospect Driver 1.4, Mindvisions gratis VISE installer voor freeware en shareware ontwikkelaars en de belachelijke problemen van ZipPlus.

Onderwerpen:

Copyright 1998 TidBITS Electronic Publishing. All rights reserved.
Information: <info@tidbits.com> Comments: <editors@tidbits.com>


Je kunt je gratis abonneren op de Nederlandse afleveringen van TidBITS door een (blanco) mailtje te sturen naar: tidbits-nl-on@tidbits.com. Je krijgt deze dan per e-mail toegestuurd.
Om je abonnement op te zeggen, kun je een mailtje sturen naar: tidbits-nl-off@tidbits.com.


Deze editie van TidBITS werd gedeeltelijk gesponsord door:


Dit nummer werd uit het Engels vertaald door:

Verder werkten mee:


MailBITS/04-Mei-98

Een grote min voor ZipPlus -- Iomega heeft recent de compatibiliteitsrichtlijnen voor de ZipPlusdrive herzien, en deze richtlijnen suggereren dat Iomega een steek heeft laten vallen bij het testen van de drive, danwel schaamteloos de werkelijkheid uit het oog is verloren. De ZipPlus kan onderscheiden of hij op een SCSI-poort is aangesloten, of op een parallelle poort middels de blauwe AutoDetect kabel. Als je deze kabel niet gebruikt, kan het gebruik van " elke kabelconverter of genderchanger", of gebruik van een multi-device SCSI-kabelketting systeem-incompatibiliteiten of verlies van data veroorzaken. Iomega specificeert ook dat de ZipPlus niet gebruikt moet worden bij PowerBooks, ongeacht welke kabel er gebruikt wordt. Willen ze misschien ook nog dat de gebruikers de ZipPlus opbergen in een koele donkere plaats, ver verwijderd van harde geluiden? We hopen dat Iomega snel een technische oplossing aandraagt voor deze problemen. [JCL]

<http://www.iomega.com/product/zip/zipplus.html>
<http://www.iomega.com/support/techs/zip/zpluswp.html>

Baby You Can Drive My Tape -- Dantz Development heeft de gratis Retrospect 4.0 Driver Update 1.4 uitgegeven, die ondersteuning toevoegt aan Retrospect voor diverse nieuwe CD-R drives, tape drives en autoloaders (apparaten die automatisch tussen verschillende tapes wisselen). Als voornaamste Macintosh-backup-programma ondersteunt Retrospect 4.0 al een grote hoeveelheid backup-apparaten; voor een volledige lijst, kun je kijken op de Dantz's Backup Mechanism Compatibility List. The Retrospect Driver Update 1.4 is een 111K download. [ACE]

<http://www.dantz.com/upgrades_and_updates/rdu.html>
<http://www.dantz.com/backup_hardware/mech_list.html>

Mailsmith borrelt op uit de smidse -- Bare Bones Software heeft vandaag het uitgeven van Mailsmith 1.0, het langverwachte e-mail clientprogramma van dit bedrijf, aangekondigd. Hoewel de markt voor e-mailprogramma's overladen schijnt, met Emailer, Eudora, Netscape Communicator, Outlook Express, QuickMail Pro en anderen, belooft Mailsmith enkele ongewone eigenschappen. Mailsmith levert multi-threaded processing hetgeen het mogelijk maakt te versturen, te ontvangen en te filteren terwijl je verder werkt; filters met meerdere criteria en meerdere acties; "fuzzy" searching; grep pattern matching in zoekcommando's en filters; database-gebaseerde mail-opslag; volledige OSA scripting en recording en de belangrijkste tekstediting functies van BBEdit. Mailsmith heeft een adviesprijs van $79. BBEdit-eigenaren kunnen het kopen voor $59. Bovendien zijn er kortingen verkrijgbaar voor gebruikers van andere e-mailprogramma's. Er is een demo beschikbaar op de FTP-site van Bare Bones die op het moment geen verbindingen accepteert.[ACE]

<http://web.barebones.com/press/msmithpr.html>
<http://web.barebones.com/products/msmith/msmith.html>

HP Inkjets worden compatibel met de Mac -- Nu de Apple StyleWriters niet meer worden gemaakt, hebben Apple en Hewlett-Packard (HP) vorige week aangekondigd dat toekomstige Inkjet-printers van HP voortaan compatibel zijn met het Mac OS, en dat Apple sommige HP Inkjetprinters zal doorverkopen aan klanten in educatie, waarschijnlijk zodat scholen computers én printers kunnen aanschaffen in één aankoop. Printers van het merk HP moeten in de loop van dit jaar ook beschikbaar worden via de directe kanalen, zoals de Apple Store. Mac OS drivers voor de HP printers zullen kennelijk niet worden gemaakt door Apple of HP, hetgeen zowel goed als slecht nieuws is daar Apple's StyleWriter-drivers erg goed waren, maar HP's Mac OS printerdrivers vaak minder. In plaats daarvan zullen Mac OS drivers voor HP-printers gemaakt worden door Infoware - makers van programma's als PowerPrint, die het Mac's in staat stelt een keur aan PC-printers te gebruiken, en StyleScript, een PostScript interpreter voor Inkjets - die misschien Apple's ColorSync kleurenmatching-technologie zullen ondersteunen.

<http://www.apple.com/pr/library/1998/apr/28hp.html>
<http://www.infowave.net/whats_new/html/04_06_98.html>

Voeg een VISE aan je Freeware of Shareware toe -- MindVision Software heeft een gratis licentie aangekondigd voor hun Installer VISE-installatiepakket. Het is echter alleen gratis van ontwikkelaars van shareware en freeware. Installer VISE 5.0.1 biedt een aantal uitgebreide kenmerken, zoals een Web-gebaseerde installer, de mogelijkheid om iconen exact te positioneren, door de gebruiker gedefiniëerde formulieren, integratie met de Updater VISE technologie van MindVision en de mogelijkheid om je product online te registreren. Op een moment dat Apple het besluit heeft genomen om zich bij de ondersteuningsprogramma's te concentreren op de 100 grootste Macintosh ontwikkelaars (zie "Razernij over developer programma's & QuickTime" in TidBITS-425) is het goed om te zien dat andere leden van de Macintosh-industrie nog wel aan kleine ontwikkelaars denken. [ACE]

<http://www.mindvision.com/Pricing/shareware.html>
<http://www.mindvision.com/News/Mac5.0/ComingSoon.html>
<http://db.tidbits.com/getbits.acgi?tbart=04821>

Eudora Internet Mail Server 2.1 Uitgegeven -- Qualcomm heeft een gratis updater uitgegeven die Eudora Internet Mail Server 2.0 of 2.0.1 op versie 2.1 brengt. De belangrijkste nieuwe kenmerken zijn ondersteuning voor IP multihoming onder Open Transport 1.3, de mogelijkheid om van afstand de queue voor uitgaande berichten te bekijken en te manipuleren, het importeren en exporteren van gebruikers en het toekennen van beperkingen aan IP adressen bij het versturen van mail. Bovendien bevat de update een aantal veranderingen aan de interface, verbeteringen van fouten en prestatieverbeteringen, wat opviel bij het downloaden van het EIMS Admin programma. Eudora Internet Mail Server 2.0.1 is alleen maar online verkrijgbaar voor $199, of $299 wanneer tegelijk vijf versies van Eudora Pro aangeschaft worden. De gratis updater is 1,6 MB groot. [ACE]

<http://eudora.qualcomm.com/eims/>
<http://eudora.qualcomm.com/eims/updaters.html>


De "Autostart" Worm Verbreekt de Rust Betreffende Mac "Malware"

door Mark H. Anbinder <mha@tidbits.com>

Bijna drie jaar nadat het laatste Macintosh-specifieke virus de kop opstak, is er een nieuw stukje Macintosh malware (code die specifiek is ontworpen met een crimineel doel) in omloop. De worm, ontworpen om data-bestanden te overschrijven, heeft zich snel verspreid in een desktop publishing-gemeenschap in Hong Kong, waar het voor het eerst gesignaleerd werd. In tegenstelling tot een virus, dat andere software nodig heeft om te functioneren, kan een worm zichzelf executeren.)

De worm, die van anti-virus analisten de naam Autostart-9805 gekregen heeft, gebruikt een kenmerk van QuickTime 2.0 en later die CD-ROMs de mogelijkheid geeft om een programma meteen te starten nadat een CD in de speler is gestopt. Bij QuickTime 2.5 en later geeft het QuickTime Instellingen regelpaneel de gebruiker de mogelijkheid om dit uit te zetten.

Mechaniek -- Analisten zeggen dat de worm kan worden doorgegeven door middel van bijna iedere HFS of HFS+ schijf, inclusief floppy disks, de meeste removable cartridge drives, magneto-optical disks, recordable CD disks, hard disks en zelfs mountable DiskCopy of ShrinkWrap disk image bestanden. De worm is alleen actief op een PowerPC systeem dat het Mac OS draait, en zal alleen werken op een computer waar QuickTime 2.0 of later opstaat met de CD-ROM AutoPlay feature aan.

Geïnfecteerde schijven bevatten een onzichtbaar applicatie-bestand genaamd DB, type APPL en creator ????. Dit bestand bevindt zich in de root directory, en het AutoPlay attribuut is vastgelegd in het startdeel van de schijf. Wanneer getracht wordt om de geïnfecteerde schijf op te starten zal de DB applicatie starten en zichzelf naar de Extensies map van de actieve Systeemmap kopiëren. Deze kopie, die eveneens onzichtbaar is, heet Desktop Print Spooler en het type is appe (verwar dit bestand niet met de zichtbare en legitieme Desktop Printer Spooler extensie). De worm herstart vervolgens de computer, en laadt vervolgens weer in het geheugen door middel van de onzichtbare Desktop Print Spooler, die weer een onzichtbare achtergrond-applicatie is en niet verschijnt in het applicatie-menu.

Zo ongeveer iedere 30 minuten zal de worm alle bestaande schijven onderzoeken en proberen om alle schijven te infecteren die dat nog niet zijn door zichzelf te kopiëren naar de root directory van deze schijven als DB met AutoPlay geschakeld. Vervolgens zoekt het op aanwezige schijven naar bestanden waarvan de namen eindigen op "data", "cod" of "csa" en waarvan de data forks groter dan 100 bytes zijn of bestanden eindigend op "dat" die groter zijn dan zo'n 2 MB. Wanneer een dergelijk bestand gevonden wordt zal de worm ongeveer de eerste 1 MB van de data fork overschrijven met onzin.

Bent u geïnfecteerd? Tot nu toe geloven antivirus experts niet dat AutoStart-9805 zich erg verbreid heeft buiten de uitgeversgemeenschap in Hong Kong, dus moet het mogelijk zijn te voorkomen dat het zich veel verder verspreidt. Controleer bij de uitgever van uw antivirus gereedschap dat u de laatste updates heeft, in gedachte houdend dat verouderde virusdefinitiebestanden waardeloos zijn! Zichtbare symptomen die u kunt onderzoeken bevatten:

Preventie -- Het risico van een nieuwe infectie wordt in feite uitgesloten door de CD-ROM AutoPlay mogelijkheid in het QuickTime Settings regel paneel in QuickTime 2.5 of later uit te schakelen, al helpt dit niet wanneer het systeem al geïnfecteerd is. Het zal ook een geïnfecteerde Mac er niet van weerhouden een onzichtbaar DB bestand aan te maken op een systeem met volumes, voor wie samengebruik actief is, op een netwerk. Versies van QuickTime voorafgaand aan 2.5 missen de mogelijkheid de AutoPlay functie uit te zetten, dus beveelt Apple's QuickTime groep aan op te waarderen naar QuickTime 2.5 als u een oudere uitvoering heeft. Uitzetten van Audio CD AutoPlay is niet noodzakelijk, omdat de normale audio CD deze worm niet kan dragen.

<ftp://ftp.info.apple.com/Apple_Support_Area/Apple_SW_Updates/US/Macintosh/System/QuickTime/Older_QuickTime/>

Utilities -- Dr. Solomon's Antivirus Toolkit en Virex zijn opgewaardeerd om deze worm aan te kunnen, en Symantec verwacht een update voor SAM uit te brengen. John Norstad's freeware Disinfectant kan dit probleem niet opsporen, dus raadt hij aan een hedendaags commercieel gereedschap te gebruiken dat het wel kan. Hij is zinnens binnenkort bekend te maken of Disinfectant opgewaardeerd zal worden om Autostart-9805 aan te kunnen.

<http://www.drsolomon.com/products/avtk/ps_mac.html>
<http://www.drsolomon.com/products/virex/>
<http://www.symantec.com/sam/>
<ftp://ftp.nwu.edu/pub/disinfectant/>

Apple's QuickTime evangelist Charles Wiltgen heeft de blijdschap van het bedrijf uitgedrukt over het feit dat "de commerciële verkopers zo snel gereageerd hebben als ze gedaan hebben." Wiltgen moedigt QuickTime gebruikers aan de CD-ROM AutoPlay mogelijkheid uit te zetten tenzij ze daar een speciale behoefte aan hebben, en een antivirus gereedschap aan te schaffen en te gebruiken.


De dood van de documentatie

door Adam C. Engst <ace@tidbits.com>

Ik heb een liedje in mijn hoofd, alleen zijn de woorden iets anders. Ik blijf Pete Seeger horen zingen, "Where have all the manuals gone, long time passing?" Ik maak me zorgen dat het wel een tijdje zal duren voordat ik stop met in gedachten meeneuriën.

Afgezien van deze week, toen ik aangenaam verrast was door het uitmuntende WebSTAR 3.0 handboek geschreven door Avi Rappoport, kan ik me de laatste keer niet herinneren dat een documentatie werkelijk indruk op me maakte. Donders, veel tegenwoordige producten worden geleverd zonder een gedrukt handboek. Wat is er gebeurt met de fantastische handboeken van voorheen, de boeken die je iets bij brachten dat niet duidelijk uit de interface bleek? Ik geef toe dat goed gemaakte handboeken altijd al eerder uitzondering waren dan regel, maar ik herinner me enkele die zich onderscheidden. Het eerste Suitcase handboek had een uitstekende behandeling van hoe fonts op de Mac werkten. En vroegere versies van het Norton Utilities handboek boden gedetailleerde informatie over Macintosh-schijfstructuren.

Hedendaagse handboeken, als ze al op papier bestaan, lijken meer op folders dan op boeken. De omvang alleen is natuurlijk geen indicatie voor de kwaliteit, maar niemand is beter toegerust om een accurate en begrijpelijke naslag informatie te leveren dan het bedrijf dat het programma maakt. Onafhankelijke boeken kunnen beter geschreven en georganiseerd zijn, en eerlijker over de tekortkomingen van een programma, maar de meeste schrijvers kunnen geen toegang krijgen tot ontwikkelaars en testers waar de bedrijfsschrijvers van genieten.

Laten we het pas verschenen Microsoft Office 98 eens onder de loep nemen. Dat is een bundeling van drie krachtige en complexe programma's: Word, Excel en PowerPoint, maar het pakket wordt slechts geleverd met een drietal dunne, resultaatgerichte boekjes (248 bladzijden voor Word, 244 voor Excel en 160 voor PowerPoint) die ervaren gebruikers hulp bieden bij het uitvoeren van bepaalde taken. In de inleiding van de handleiding voor Word staat zelfs letterlijk dat "de mensen die het meest aan dit boek zullen hebben diegenen zijn die Word al een tijdje gebruiken en er meestal in slagen het programma te laten doen wat zij willen." Nieuwe gebruikers worden verwezen naar het hoofdstuk "Op weg" (50 pagina's), dat alleen de allereerste beginselen behandelt, terwijl gevorderde gebruikers en systeembeheerders naar de Microsoft Office Resource Kit op het Web worden gedirigeerd (ook, voor $60, leverbaar als een uitgave van Microsoft Press).

<http://www.microsoft.com/office/ork/>
<http://mspress.microsoft.com/prod/books/1329.htm>

Nog even los van een echt verwarrende stijlkwestie (op een Mac klik je niet op menu's, maar kies je er opties uit), is de documentatie van Office nog niet eens zo slecht - een op het uitvoeren van taken gerichte Help is bijzonder waardevol. De documentatie is alleen niet volledig, omdat zij het degelijke referentiegedeelte mist dat Microsoft vroeger wel leverde, een omissie die verschillende TidBITS lezers al hebben gesignaleerd. De Microsoft Office documentatie is maar een van de vele voorbeelden van niemendallerige handleidingen die ik de afgelopen tijd onder ogen heb gekregen, waaronder die van Qualcomms Eudora Pro 4.0.

Handleidingen op hol -- Waar zijn al deze handleidingen dan heen gegaan, en waarom hebben ze ons verlaten? De voornaamste oorzaak is gelegen in de kosten; het kost geld om goede technische schrijvers een handleiding te laten schrijven waar de mensen wat aan hebben, om nog maar te zwijgen van de drukkosten. Dikke boeken leveren bovendien hun bijdrage aan het gewicht van het totale pakket, wat uiteindelijk resulteert in hogere verzendkosten. Waar dat toe leidt, zie je bij het recent verschenen Grammarian (van Casady & Greene), dat met een elektronische handleiding $80 kost; als je prijs stelt op een papieren exemplaar kost je dat $15 extra.

<http://www.casadyg.com/products/grammarian/>

Als de beperkingen voornamelijk hun oorsprong in de materiële wereld vonden, zouden we tenminste uitstekende elektronische handleidingen kunnen verwachten; tegenwoordig is de elektronische documentatie echter meestal minstens zo slecht als wat er wèl in druk verschijnt. Ik denk dan ook dat de oorzaak voor de beroerde kwaliteit van de meeste handleidingen dieper moet worden gezocht.

Voor een (klein) deel is Apple verantwoordelijk te stellen voor deze trend, omdat Apple, door een consistente "look & feel" van Macintosh-programma's af te dwingen, het gebruiksgemak van computerprogramma's aanzienlijk heeft vergroot. Als zulke conventies ontbreken, heeft de gebruiker eerder behoefte aan een goede handleiding, vooral als er bovendien geen sprake is van een visuele manier om dingen te ontdekken (denk aan de command line-interface van DOS en Unix) - hoe zou hij anders kunnen weten wat hij moest doen?

Maar ons, als gebruikers, valt ook van alles te verwijten. Tenslotte is het credo van de Mac-gebruiker altijd "Ik lees nooit een handleiding" geweest. En meestal doen we dat ook niet. Gebruikers verwachten dat software zo makkelijk in het gebruik is, dat documentatie in feite niet meer is dan een overtollig aanhangsel. Sommige producten zijn ook zo eenvoudig, maar vele andere niet. Jammer dat het voor producenten goedkoper is om dunne boekjes bij hun software te leveren, waardoor hun producten ook eenvoudig lijken, zelfs als het gaat om ingewikkelde en krachtige programma's.

Ik heb dezelfde ontwikkeling gezien bij computerboeken. Als schrijver van een bona fide boekwerk - Internet Starter Kit for Macintosh - was ik verbaasd te merken hoeveel mensen eigenlijk minder informatie hadden gewild. Ze hadden geen bezwaar tegen de prijs, ze wilden gewoon niet het hele boek lezen en hadden moeite met het overslaan van gedeelten die duidelijk niet voor hun bedoeld waren. "Fascinerend," dacht ik. "In het extreme getrokken, zouden mensen dus zonder problemen $30 uitgeven voor helemaal géén informatie!"

Maar ook het Internet is gedeeltelijk verantwoordelijk voor de ontstane situatie. Hoezeer ik ook geloof in het nivellerende vermogen van het Internet in zijn hoedanigheid als democratisch platform voor het geven van meningen, veel van wat ik op het Net zie mist de glans van professioneel geschreven, georganiseerde en geredigeerde tekst. Dat hindert ook niet als het informatiegehalte maar hoog genoeg is, maar veel van wat er op het Internet verschijnt is van een zo bedroevende kwaliteit, dat daardoor het verwachtingspatroon in negatieve zin wordt bijgesteld, speciaal op het gebied van documentatie.

Tenslotte: schrijvers van handleidingen hebben hun zaakjes meestal redelijk voor elkaar, hoewel bevlogenheid vaak ontbreekt. Maar het zijn in de meeste gevallen geen docenten, mensen die hun brood verdienen met het vinden van de beste manier om ingewikkelde dingen aan een uiteenlopend publiek uit te leggen. Het zo goed mogelijk organiseren en verwoorden van informatie is niet makkelijk, en de behoeften van de lezer moeten altijd op de eerste plaats staan. Diegenen die uit het oog verliezen dat ze bezig zijn de lezer te helpen leren, zullen onvermijdelijk middelmatige handleidingen afleveren.

De automatische piloot -- Het is niets voor mij om te klagen over de staat waarin documentatie verkeert zonder suggesties te brengen die de situatie kunnen verbeteren.

Ten eerste, gebaseerd op het commentaar dat ik op mijn boeken ontving, geloof ik dat al het geschreven werk een stem moet hebben. Toon een duidelijke houding, en laat wat persoonlijkheid door de documentatie heen komen. Een fascinerend voorbeeld van dit probleem is de documentatie bij Microsoft Office 98. De gedrukte handleiding en de electronische hulp zijn nogal droog, maar één van de belangrijkste eigenschappen van het programma is de toevoeging van Max, de personaliseerdbare Mac-achtige Office assistent. Hoewel de opmerkingen van Max af en toe irritant zijn, heeft hij zijn liefhebbers, omdat hij leven brengt. De handleiding en de electronische hulp kunnen hun voordeel doen met een dergelijke persoonlijke noot.

Ten tweede, electronische documentatie vergt aandacht als het goed moet gebeuren. De eerste beslissing betreft het electronische formaat, en dat is iets waar je over na moet denken voordat je de documentatie begint te maken. Bijvoorbeeld, veel bedrijven drukken hun handleidingen af naar een PDF-document en leveren Acrobat Reader met de software bij. Dat is een goedkope uitweg en in de meeste gevallen resulteert het in onbruikbare documentatie.

Als je PDF gebruikt, maak dan een ontwerp dat zowel op het beeldscherm als in afgedrukte vorm leesbaar is. De versie voor het beeldscherm zou lettertypes moeten gebruiken die veel op het beeldscherm gebruikt worden, en PDF eigenschappen als navigatie markeringen en links moeten gebruiken. PDF bestanden zouden ook melding moeten maken van de zoek-functionaliteit van Acrobat - je kunt niet aannemen dat mensen expert zijn in het gebruik van Acrobat. Zoeken is belangrijk - als je een ander electronisch formaat gebruikt, let er dan op dat erin gezocht kan worden! Een voorbeeld van een goede set op PDF gebaseerde documentatie is de handleiding van het nieuwe Retrospect Express van Dantz Development. Hoewel het wat teleurstellend is dat het programma met slechts 12 bladzijden gedrukte documentatie komt (per taal gerekend in het Engels, Frans en Duits) is de electronische handleiding kompleet, goed geschreven, en ontworpen voor het scherm (hoewel het ook tips bevat voor het afdrukken). Het biedt ook navigatiemarkeringen en heeft zelfs een "levende" inhoudsopgave en index waarin je op hoofdstukken kunt klikken en direct naar de bijbehorende pagina springt.

<http://www.dantz.com/sp/808.html>

Hoewel PDF relatief gemakkelijk te maken is, in het bijzonder voor een electronische versie van een papieren handleiding, is HTML wellicht meer gangbaar vandaag de dag. Echter, een HTML-versie van een handleiding is niet noodzakelijkerwijs een ideale oplossing. Web browsers kunnen slechts een enkele pagina doorzoeken, en niet een hele set pagina's (al kun je een link opnemen naar een eigen web site waarop een zoek-engine staat). Lever mensen ook voldoende navigatiemiddelen, omdat het anders frustrerend is in de handleiding rond te bladeren.

Met een Blanko Cheque -- Grote bedrijven hebben helemaal geen excuus om een handleiding beneden de maat te leveren, in het bijzonder bij hun belangrijkste producten, welke vaak voor honderden dollars de deur uit gaan. Goede documentatie doet de ontwikkelkosten vast stijgen, maar deze bedrijven spenderen al grote bedragen aan documentatie.

Voor grote bedrijven is de oplossing denk ik eenvoudig. Huur een professionele schrijver in om de handleiding te schrijven. Kijk maar eens naar het aantal onafhankelijke boeken dat over een bekend pakket geschreven wordt. Veel van deze boeken verkopen niet meer dan 10.000 tot 15.000 exemplaren, waardoor de auteur tussen de $10.000 en $20.000 verdient, voor belasting. Een groot succesvol bedrijf kan gemakkelijk $40.000 tot $50.000 uitgeven om iemand (of zelfs een groep mensen) aan te nemen om een topkwaliteit handleiding te maken. Zeker, de auteur krijgt geen auteursrechten op een best-seller, maar veel uitgevers streven er naar auteurs zover te krijgen boeken te schrijven "in opdracht" zodat auteursrechten nooit ter sprake komen.

Het argument dat er meer komt kijken dan gewoon schrijven bij het maken van een handleiding snijdt ook geen hout. Ervaren auteurs doen vaak veel meer bij het uitgeven van een boek dan schrijven. Sommige uitgevers maken auteurs verantwoordelijk voor de index (professionele index makers zijn altijd beter dan amateurs - zie het artikel van David Holzgang "The All-Important Index" in TidBITS-333) en eisen dat auteurs Postscript bestanden leveren. Mijn Eudora Visual QuickStart Guide bijvoorbeeld schreef ik naar de stijl van Peachpit, maakte de layout met een QuarkXPress template, overtuigde Tonya dat ze de redactie moest doen, en betaalde een index maker om de index voor me te maken.

<http://db.tidbits.com/getbits.acgi?tbart=00963>

Als een groot bedrijf niet geëntereseerd is in het vinden van een individuele auteur, waarom dan geen contact opgenomen met een uitgever die deze diensten ook kan leveren? Een uitgever inschakelen zal de kosten omhoog brengen, maar kan in een handleiding van nog hogere kwaliteit resulteren, omdat uitgevers beschikken over professionele redacties en produktie afdelingen. Op zijn minst zijn de uitgevers toch al bezig met het maken van deze boeken. Ik zou de meeste handleidingen die ik de laatste tijd gezien heb met veel plezier inruilen voor de Visual QuickStart Guides van Peachpit, hoewel deze taak-georiënteerd zijn en geen gedetailleerde referentie-informatie bevatten.

Het maken van een handleiding kan de kosten voor technische ondersteuning omlaaghalen, maar veel bedrijven laten zich betalen voor ondersteuning, dus het terugbrengen van de noodzaak voor ondersteuning is wellicht geen voordeel. Erg cynische mensen zouden stellen dat het uitbrengen van een slechte handleiding de winst uit de ondersteuning omhoog jaagt.

Documentatie als Kleinigheid -- Wat betreft kleine firma's? Al lijken de mogelijkheden somber, kleine firma's hebben niet dezelfde zorgen, want het ligt voor de hand dat ze minder ingewikkelde produkten maken. Wat niet wil zeggen dat kleine produkten aan dokumentatie kunnen ontkomen. Een goed LeesMij bestand is onontbeerlijk, vooral bij software die uitsluitend via het Internet gedistribueerd wordt. Tonya heeft meerdere artikelen over dit onderwerp geschreven de laatste jaren, veelal als reaktie op het zich ergeren aan waardeloze LeesMij bestanden.

<http://db.tidbits.com/getbits.acgi?tbser=1039>

Hoe onontbeerlijk een LeesMij bestand ook is, de meeste programmas hebben ook een gebruiksaanwijzing nodig. Al kunnen kleinere firma's waarschijnlijk geen professionele schrijver bekostigen, sta me toe een eenvoudig schema voor een gebruiksaanwijzing te opperen. Voel je er niet door gebonden, maar als je deze onderdelen in kunt brengen, zou je uiteindelijk tot iets bruikbaars kunnen komen.

Ik wil niet veinzen dat het maken van bruikbare documentatie gemakkelijk is, maar denk wel dat het een nuttige inspanning is, vooral t.a.v van toenemende tevredenheid van de klant en vermindering van kosten voor technische bijstand, die aanzienlijk kunnen zijn voor kleinere firma's en individuele ontwikkelaars.


Niet-winstgevende en niet-commerciële publicaties en Websites mogen artikels overnemen of een HTML link maken als de bron duidelijk en volledig vermeld wordt. Anderen gelieve ons te contacteren. We garanderen de precisie van de artikels niet. Caveat lector. Publicatie-, product- en firmanamen kunnen gedeponeerde merken zijn van hun ondernemingen.

Vorige aflevering | Search TidBITS | TidBITS Homepage | Volgende aflevering