[stylist] Technical Writing

[Robert Leslie Newman]

John

So are you yourself having writers bloc and want to get shut of it? (I'd
just say, "Dude, tell me about your product? Like give me the manual in
conversational lingo!)

[I do technical writing too. And I sure enough try to write it so it does
not come across as being "technical." 
is 

-----Original Message-----
From: stylist-bounces at nfbnet.org [mailto:stylist-bounces at nfbnet.org] On
Behalf Of Ashley Bramlett
Sent: Monday, April 02, 2012 4:43 PM
To: Writer's Division Mailing List
Subject: Re: [stylist] Technical Writing

John,
What is your braille transcription suite? what do you mean?

-----Original Message-----
From: John J. Boyer
Sent: Saturday, March 31, 2012 7:33 PM
To: Writer's Division Mailing List
Subject: [stylist] Technical Writing

This is not off-topic. Technical writing is a non-fiction jenre. The
particular case I have in mind is the documentation of my braille
transcription suite, liblouis, liblouisutdml and BrailleBlaster. This suite
is Open Source and free. As important as technical writing is to a software
development project, the developers, who must often write the manuals as
well as the programs, often have great difficulty with writers' block, and
there is always the danger that they will write for other programmers rather
than the people who actually use their product.
In the case of the Braille Transcription suite, good documentation is
important for all Braile readers, especially those in mathematicss and
technical fields. I've been so busy with the code that I haven't given
documentation the attention it needs, to say nothing of writers' block.
Any suggestions will be appreciated.

John

--
John J. Boyer, Executive Director
GodTouches Digital Ministry, Inc.
http://www.godtouches.org
Madison, Wisconsin, USA
Peace, Love, Service


_______________________________________________
Writers Division web site:
http://www.nfb-writers-division.net <http://www.nfb-writers-division.org/>

stylist mailing list
stylist at nfbnet.org
http://nfbnet.org/mailman/listinfo/stylist_nfbnet.org
To unsubscribe, change your list options or get your account info for 
stylist:
http://nfbnet.org/mailman/options/stylist_nfbnet.org/bookwormahb%40earthlink
.net 


_______________________________________________
Writers Division web site:
http://www.nfb-writers-division.net <http://www.nfb-writers-division.org/>

stylist mailing list
stylist at nfbnet.org
http://nfbnet.org/mailman/listinfo/stylist_nfbnet.org
To unsubscribe, change your list options or get your account info for
stylist:
http://nfbnet.org/mailman/options/stylist_nfbnet.org/newmanrl%40cox.net