This is the Message Centre for h2g2 Operations
Technical writing ... OIK !
Rev Nick - dead man walking (mostly) Started conversation Dec 30, 2011
How-ever, over 35 years of military involvement, I have had no choice but to write quite a lot of documents that are
painfully, boringly plain and clear to the lowest possible denominator
As a "from-scratch" help-page author, I am probably not the best candidate, but I can certainly throw in help with 2nd
readings, proofings, etc. And trying to clarify things that become a jumble after too many hours at the key-board for
the zombified author.
Technical writing ... OIK !
h2g2 Operations Posted Dec 31, 2011
Now that IS useful, Nick.
What are you like with Guide ML - if we pass you some things for sense- and sanity-checking could you turn them into GML too?
Technical writing ... OIK !
Rev Nick - dead man walking (mostly) Posted Dec 31, 2011
It's been atleast 6 or more years since I worked up a PS from scratch, so I'd be quite rusty. Common 'paragraph' separations and blocks are okay, but much like headers, bullets, etc ... Not so much. I could brush up some, I suppose from some of Laura's (Unconformity then) workshop pages.
But not for atleast another week or so. The first few days of the new year will be busy with the monthly creation of a newsletter that I publish for our Wing (AFAC)
Technical writing ... OIK !
Mrs Zen Posted Dec 31, 2011
It's more likely to be February.
Maybe I should write about the work that goes into drafting the help pages.
Another day another journal...
Ben
Technical writing ... OIK !
Rev Nick - dead man walking (mostly) Posted Dec 31, 2011
I know that the Beeb help pages spanned and spanned and cross linked, an average Jane or Joe could go cross-eyed before they found what might seem related to a first query. It's not an easy thing, making a useful manual on paper, I imagine it is far more complicated with nesting of pages.
At your convenience, after the new year needs, etc, ... Drop me a note as to product-builds, where to find them, browse and see if I think that I can help? Something that I did learn a couple of decades ago, I can see where I can be a help, and also easily see where I can not. I won't blow hot air as to how fab and great I might be. I know my reaches, and I know some of my own limits
Technical writing ... OIK !
h2g2 Operations Posted Jun 19, 2012
Nick,
currently Magwitch is working on coordinating help page updates. Would you like to contact her and help her?
Milla
Technical writing ... OIK !
Rev Nick - dead man walking (mostly) Posted Jun 24, 2012
I'll drop her a note on FB. When the offer was made, I was still in an indeterminate state of unemployment.
I am well back there, excessively 'whelmed' (thought not overhwelmed) from the build up of 11 months without
us actual workers. And my evenings are busy enough dealing with the business needs of a small town marina
and our own chapter of the Air Force Association of Canada.
In brief(er), I'll see if I still have time to offer
Key: Complain about this post
Technical writing ... OIK !
- 1: Rev Nick - dead man walking (mostly) (Dec 30, 2011)
- 2: h2g2 Operations (Dec 31, 2011)
- 3: Rev Nick - dead man walking (mostly) (Dec 31, 2011)
- 4: Mrs Zen (Dec 31, 2011)
- 5: Rev Nick - dead man walking (mostly) (Dec 31, 2011)
- 6: h2g2 Operations (Jun 19, 2012)
- 7: Rev Nick - dead man walking (mostly) (Jun 24, 2012)
- 8: Milla, h2g2 Operations (Jun 24, 2012)
More Conversations for h2g2 Operations
Write an Entry
"The Hitchhiker's Guide to the Galaxy is a wholly remarkable book. It has been compiled and recompiled many times and under many different editorships. It contains contributions from countless numbers of travellers and researchers."