Newsletters – technical writing

One of the things I like to do is browse the internet looking for articles, blogs and newsletters with new insights in the world of techncial writing. There are many, there must be more, as our professional field is wide ranged, from software manuals to creating virtual deliverables for machines. We still work with Word... Lees verder →

Uitgelicht bericht

10 documentation mistakes

The best way for a technical writer to find mistakes is have his documentation checked.   I once gave a software manual to the girl at the reception, It was an eye-opener. Obvious steps were missing and she could not complete some of the procedures. Just recently I got stuck myself trying to troubleshoot some drive... Lees verder →

Uitgelicht bericht

Ben Ali Libi – de goochelaar van Willem Wilmink

Afkomstig uit een armoedig gezin, met een vader met artistieke aspiraties, begon Michel Velleman op jonge leeftijd onder de naam Ben Ali Libi te goochelen. Vingervlug en met een vaardige tong vertoonde hij zijn kunsten. Hij was meer bekend dan beroemd. Tot de oorlog aan alles een einde maakte. Willem Wilmink schreef een gedicht over... Lees verder →

Uitgelicht bericht

Documentation trends 2018

2017 nearly down the drain. Hope it was a good year for you full of things to remember. If not, there is always 2018.  What it will bring is still written in the clouds. But having a look at many sources you could come up with some trends for documentation. What will 2018 bring for... Lees verder →

Uitgelicht bericht

Negen technical writer mythes

Laatst had ik een gesprek met een manager: hoe krijgt mijn team van technical writers meer gewicht? Nu hangen ze er wat bij binnen het bedrijf. Hoog tijd om de mythbusters van stal te halen. Dan wordt veel duidelijk over het werk van de technical writer, zijn persoonlijkheid, zijn waarde voor het bedrijf  en zijn... Lees verder →

Uitgelicht bericht

Hoe hot is de chatbot?

Jaren terug maakte ik documentatie die in een klapper ging en bij de klant op een plank werd gezet. Geen idee of die handleiding ooit gebruikt is. Wie zou er gebruik van maken? Wie wist dat de handleiding op de plank stond? Van papier naar online help Na het papier volgden de online help bestanden.... Lees verder →

Uitgelicht bericht

Contact

Daar sta je dan met je bul in  je hand. Het zijn de grauwe jaren tachtig. Je kunt de straat plaveien met werkloze academici. Tom Poes, verzin een list! Schrijven was wat ik kon, schrijven wat was ik deed, schrijven was wat ik zou gaan doe. Nu vele jaren later, met een schat aan ervaring, ... Lees verder →

Uitgelicht bericht

Top of the docs…rating the three most important documentation aspects

Rating what is most inportant in documentation could take ages op pondering, shaking ones head in frustration or be a complete nightmare. Throughtout the years my list, let's call it a top-3 of most important documentation aspects, changed. And even with the list i am now presenting i'm not completely certain. Maybe it's just personal.... Lees verder →

Advertenties

Some tools for better documentation

If i had to make a top three of the most important factors regarding user documentation, this would be my list: Audience Searchability Readibility In another blog i will go deeper into this choice. This little blog will be about number three; tools to improve readibility. The rules of the game are clear: avoid complexity,... Lees verder →

MadCap Flare some simple tips & tricks (7)

Nothing fancy, maybe something handy, maybe something useful. The tips in this blog answer the following questions: How do i remove heading levels from my TOC? How do i pimp my documentation with a fanciful note? How do i setup alternating headers and footers in my document? TOC - remove heading levels This is the... Lees verder →

MadCap Flare – some simple tips & tricks (6)

Why look all these manuals so dull. Somehow customers dont want to stand out with colorful documentation. And...really, there are quite a few ways to pimp documentation in MadCapFlare. What about a different look and feel for your TOC. Ever thought about working on the stylisation of numbered lists? A colorful TOC Just assume you... Lees verder →

Blog op WordPress.com.

Omhoog ↑