I’m currently working on a draft for a proposed new standard on developing user documentation in an agile environment. There is a lot of information out there about agile software development, but most of it is focused towards code developers, and possibly project managers. What I have noticed is there is very little advice out [...]
Read Full Post »
Posted in Uncategorized, tagged dequeue, docs, documentation, enqueue, message broker, test client, test message, testing, toolkit, websphere message broker, wmb on July 17, 2008 | Leave a Comment »
There is a hiccup in the WebSphere Message Broker documentation in the topics that talk about putting and getting test messages from within the WebSphere Message Broker toolkit. The topics that talk about putting and getting test messages in the debugging section haven’t been properly updated for changes in v6.1. The enqueue and dequeue functions are still [...]
Read Full Post »
Posted in Uncategorized, tagged broker, documentation, ftp site, information center, latest, message broker, mqsi, update, websphere message broker, wmb on May 30, 2008 | Leave a Comment »
To coincide with the release of fixpack 2 of WebSphere Message Broker v6.1 there has been an update to the documentation in the fixpack, and also on our online information center website. Alternatively you can download the latest help as a standalone information center or set of PDF books from the ftp site.
Read Full Post »
Posted in usability, work, writing, tagged berlin, documentation, iso, sc7, software, standards, testers, testing, usability on May 29, 2008 | Leave a Comment »
I’ve recently got back from the ISO/IEC JTC 1/SC 7 Plenary meeting in Berlin. In case you don’t understand the acronym, this is a meeting of the Software and systems engineering sub-committee of the International Standards Organisation. SC7 and it’s working groups meet twice a year, with the Plenary held in May, and working group meetings [...]
Read Full Post »
Posted in message broker, usability, work, writing, tagged documentation, eclipse, help, infocenter, message broker, mqseries.net, mqsi, search, usability, useful, wmb, wmq, work on March 14, 2008 | Leave a Comment »
As promised in the previous post, here are the instructions on how to add specific search locations to your Help view.
To add new search locations to your Help view, press F1 to display the Help view, and click on the Search tab. Expand the Search Scope section, and click on Advanced Settings to display the [...]
Read Full Post »
The Help View was a new feature in Eclipse v3.1, and toolkits that are built on this technology. You can access the Help view within Eclipse by pressing F1 (or shift+F1 on Linux), click on the question mark in a wizard, or selecting Dynamic Help from the Help menu. The Help view displays context sensitive help depending on [...]
Read Full Post »
Posted in usability, work, writing, tagged documentation, eclipse, GUI, interfaces, terminology, tooling, usability, work, writing on February 5, 2008 | 2 Comments »
One thing I find that makes writing difficult is the confusing mass of terminology around GUI interface elements such as buttons, menus, pages, windows, tabs and so on. Many of the tools that I work with have standard elements that have standard names. For example in the Eclipse platform the main ones are workbench windows, perspectives, editors and [...]
Read Full Post »
