API: “it’s the documentation, stupid!”

Een paar jaar geleden werd aan 250 Amerikaanse API-ontwikkelaars gevraagd wat zij het belangrijkste element van een te integreren API vonden. Het antwoord was eenduidig: documentatie! Een jaar later gaf John Musser een voordracht met daarin tien redenen waarom ontwikkelaars zo'n API het liefst links zouden laten liggen. De documentatie deugt niet, is onduidelijk en... Lees verder →

Markdown: wat moet je ermee?

Markdown is een eenvoudige manier om webteksten te maken zonder de overdadige opmaak van HTML of XML. Je leert het in tien minuten. Hieronder zie je een voorbeeld. Beperkingen Zo eenvoudig en dan zo weinig gebruikt?! Tenminste niet door technical writers. De applicaties waar die mee werken (Author-It, XMetal, RoboHelp, MadCapFlare) ondersteunen het niet. En... Lees verder →

Blog op WordPress.com.

Omhoog ↑