In the Madcap world of Flare (yes, I promise never to say that again), you can use stylesheets to give your tech docs a real edge. For me, styles are one of the hidden secrets in Flare. So, if you plan to publish your tech docs to PDF, Web, or HTML5, a crash course in CSS […]
Conditional text is one of those writing tactics technical writers love to talk about… but never seem to use. It’s a shame as conditional tagging can save you a lot of time, especially if you have technical documents which share 90% of the content but the other 10% needs to be tweaked for each release. […]
Snippets? Sounds familiar but what are they? In the Madcap world of Flare, snippets are content ‘fragments’ you can re-use in different parts of your Madcap Flare projects. Use snippets to insert: Text Tables Images Video Why Use Snippets If you find yourself typing the same text over and over, create a snippet instead. Create […]
Creating web forms is harder than you’d think. Yes, it looks easy but… Before I forget — try Formstack if you want stunning-looking web forms. So, let’s say you’re designing a form for your company’s website. How can you make sure uses don’t get frustrated, impatient, or annoyed and leave your site? The last thing […]
Do you provide an index for your online documents? I’m not sure if today’s customers actually want an index. Maybe they prefer to search. Of course, not everyone agrees with me. Lori Lathrop, author of An Indexer’s Guide to the Internet, helps firms index their technical publications for software, manufacturing, and science. She highlights four […]
Ben says: “The goal of a project is to make the user successful at what he wants to accomplish. Go ahead, read that previous sentence a few times. It’s one that would do well to sink in.” Is this true?