This morning, I found out that you can be something called a "freelance indexer". That is one more field that had never crossed my mind, as I figured that indexing was probably done by robots.
In fact, I once saw a demonstration of a prototype robo-indexer, that would automatically semantically link keywords in documentation to their definitions. The prototype has yet to result in a more robust tool, so I guess that humans will play a large part in creating indexes for a while still.
If you want to learn more about indexing, maybe you should look into this course. Goes down in Sydney on the 28th of June.
13 May 2013
10 May 2013
Web-based Writing Critic Robot
It was only a matter of time before "going to the internet for an opinion" on your writing literally meant "going to the Internet for an opinion".
Slick Write is an internet tool (Robot) that claims to be able to give you stylistic advice on your writing. This goes beyond grammar, beyond even the Gunning Fog check.
Here is how their feedback breaks down, straight from the horses mouth:
Slick Write is an internet tool (Robot) that claims to be able to give you stylistic advice on your writing. This goes beyond grammar, beyond even the Gunning Fog check.
Here is how their feedback breaks down, straight from the horses mouth:
- Critique - This tab contains the body of text with stylistic features highlighted.
- Structure - Here you will find the sentences color coded by type and length.
- Flow - Hold your readers' interest by maintaining good flow.
- Stats - This is where you will find important statistics on a variety of subjects including readability, word frequencies, and repeated phrases.
07 May 2013
Whats the point? Article 4: Provide services like meetings, publications, seminars and conferences.
This series has taken longer than I thought it would, which I guess must be a life lesson. That being said, let's get started!
The STC Australia Chapter's charter has as article 4:
"to provide services for Australian technical communicators in the form of meetings, publications, seminars and conferences"
Australian technical writers are widely dispersed, and our approach to providing these services has to recognize how far we live from one another. Hence, our monthly meetings are held online.
This Thursday's meeting promises to be a real hair-raiser! Over the course of up to two hours, we'll be discussing...
The STC Australia Chapter's charter has as article 4:
"to provide services for Australian technical communicators in the form of meetings, publications, seminars and conferences"
Australian technical writers are widely dispersed, and our approach to providing these services has to recognize how far we live from one another. Hence, our monthly meetings are held online.
This Thursday's meeting promises to be a real hair-raiser! Over the course of up to two hours, we'll be discussing...
What do you know about typography?
I thought it would be worthwhile to share this video, because without typography there would be no technical writing. Feel free to watch it at the office, and call it work!
09 April 2013
A Documentation Cautionary Tale.
Heroku, a platform as a service (PAAS) cloud service provider, was caught with documentation that described software that subscribers weren't getting.
In this documentation bait-and-switch, Heroku's documented a technology that they'd removed from their product because it didn't scale with their increasing customer base.
Eventually, they had to admit that their documentation was about 2 years out of date, which they chalked up to "focus on new products". They burned their own clients, and their potential future clients, by showing themselves to be untrustworthy.
There is a warning there: documentation is a type of advertising. It had better describe what customers are paying for!
In this documentation bait-and-switch, Heroku's documented a technology that they'd removed from their product because it didn't scale with their increasing customer base.
Eventually, they had to admit that their documentation was about 2 years out of date, which they chalked up to "focus on new products". They burned their own clients, and their potential future clients, by showing themselves to be untrustworthy.
There is a warning there: documentation is a type of advertising. It had better describe what customers are paying for!
05 April 2013
How does the brain process language?
I like Lifehacker. It, like anything, can be hit and miss. Today, though, they hit gold with this excellent article about how the human mind understands language.
Some cool takeaways: the 5 most persuasive words in the English language, the secret to effective questions that will produce useful answers, and the psychological impact of "is".
Check it out!
Some cool takeaways: the 5 most persuasive words in the English language, the secret to effective questions that will produce useful answers, and the psychological impact of "is".
Check it out!
16 March 2013
What's the point? Article 3: Promote Industry and Public Awareness about Technical Communications
In this third entry in the "What's the Point?" series, we'll look at article 3 of the STC Australia Chapter's charter:
"to promote industry and public awareness about technical communications and technical communicators within Australia"
This charter item requires some obvious questions be answered.
Which industry should we be trying to reach? The industries that employ us? Those that don't, but could?
As for making the public more aware us us, why? I'll focus on industry awareness, because that is where I can see the upside.
"to promote industry and public awareness about technical communications and technical communicators within Australia"
This charter item requires some obvious questions be answered.
Which industry should we be trying to reach? The industries that employ us? Those that don't, but could?
As for making the public more aware us us, why? I'll focus on industry awareness, because that is where I can see the upside.
Subscribe to:
Posts (Atom)