Best Programmers

  • Subscribe to our RSS feed.
  • Twitter
  • StumbleUpon
  • Reddit
  • Facebook
  • Digg

Friday, 9 September 2005

Aah?

Posted on 01:50 by Unknown
The other day a couple of my colleagues were discussing about the bad habit of adding the ‘aah’ sound while phrasing a question. I don’t know if it is bad; but it sure will give ulcers to the purists.
Take for example how ‘are you coming with us?’ is brutally hacked to a single word question: coming-aah?
Or, the totally new form of exclamation: ‘Yes-aaah?’ that roughly translates to ‘don’t tell me it is true!’  
Or the usual friendly enquiry ‘you ate-aah?’ that is the equivalent of ‘did you have your lunch?’
The ‘aah’ sound is widely used—especially in interrogative phrases— in Tamil and Telugu:
‘Saapteengalaah?’ (Did you eat? - Tamil)
‘Varreengalaah?’ (Are you going with us? – Tamil)
‘Baavunnaaraah?’ (How are you? – Telugu)
‘Bon-chesaraah?’ (Have you eaten? – Telugu)

And we south Indians use the same construction even while conversing in English. I think it is a unique fusion of two different linguistic rhythms. The purists may scoff at it, but I enjoy using it and listening to others use it.
You like it-aah?
Read More
Posted in | No comments

Monday, 5 September 2005

Tech writer or DTP Expert?

Posted on 04:15 by Unknown
I saw these requirements for a technical writer opening on one of those ‘Urgent-wanted tech writers’ mails:
  • HTML programming, Javascript
  • Microsoft Office suite (Word, PowerPoint, Excel), Microsoft FrontPage
  • Macromedia Dreamweaver
  • Macromedia Flash
  • Adobe Photoshop, Adobe ImageReady, Adobe PageMaker, Adobe Acrobat,
  • RoboHelp
  • Microsoft Visio

I wonder why they left out C, C++, Java, and VisualBasic? Why, why? When will they learn to tell a writer from a DTP professional? What has Flash got to do with a tech writer’s job? Javascript for heaven’s sake!
Read More
Posted in | No comments

Thursday, 18 August 2005

A brand name gone wrong

Posted on 23:12 by Unknown
"Did you know that Heroin was originally a brand name for cough syrup? In 1874, German scientists developed a formula for a painkiller that they thought would be less addictive than morphine. They simply added two acetyls to morphine to synthesize diacetylmorphine.

Heinrich Dreser, the head of Bayer drug development tried it on animals and humans. He, also, tried it on himself, which may have been the problem. He was very pleased with the results and decided it was a good treatment for many ailments especially respiratory ones like bronchitis, asthma and tuberculosis." Read more on Free Enterprise Land
Read More
Posted in | No comments

Wednesday, 3 August 2005

Interactive Documentation

Posted on 03:03 by Unknown
Novell has a 'Comments' feature on its product documentation pages. User can leave their feedback instantly, instead of sending an E-mail later. (But why does the RSS link fail on your site guys?)

Microsoft too has an instant feedback feature for its documentation, but somehow I don't like it. It appears to be complex, as compared to Novell's.
But I like PHP.net's interactivity the best. Don't ask me why. It is just subjective I guess.

Anyway, out of curiosity I went to Apple's iPod site (I own a Shuffle) and I discovered to my utter dismay the terrible feedback mechanism they have. Gray text on gray background and they expect users to notice that 'Provide Feedback' link. Ambitious. I expected something better from Apple.
Read More
Posted in | No comments

Monday, 1 August 2005

Review of Screen Capture Tools

Posted on 21:40 by Unknown
Check out the Review of Screen Capture Tools. Neat.

[Via Usable Help]
Read More
Posted in | No comments

Tuesday, 7 June 2005

Microsoft goes the RSS way

Posted on 04:31 by Unknown
The Microsoft Help and Support site is now providing an RSS feed (Really Simple Syndication) for its Knowledge Base (KB) articles. [Link]

Well, well, well. MS is only syndicating its KB articles, but I am thinking a step ahead: deliver a user manual (also) through RSS. Most organizations are moving (or have moved already) to XML based authoring, and generating RSS feeds from there should be a walk in the park.

Aside: What would happen if online manuals had a 'Comments' feature like in our blogs? Chew on it.

Read More
Posted in | No comments

Monday, 6 June 2005

To Click or Select...

Posted on 02:20 by Unknown
Your styleguide says it is 'select'. The whole world says 'click'. You are confused. So am I. I have tried being informal while writing instructions: "Hit the Submit button to complete regiustration." But they spanked me for being so casual and changed 'hit' to 'select'. You know, no one reads manuals. Now I know why.
Read More
Posted in | No comments
Newer Posts Older Posts Home
Subscribe to: Posts (Atom)

Popular Posts

  • Use it before you write it.
    From the Nikkor ED 80-400mm f/4.5-5.6D VR Review (emphasis is mine): [quote] Here's the warning in the manual : "When the camera is...
  • Participative Help Design
    Participative Help Design I used a weblog script to create online help for -uh- using weblogs. I used a plugin to pull help topics as alphab...
  • 3rd STC Chennai Meet this sunday.
    3rd STC Chennai Knowledge Sharing Session this sunday, April 4th. This month's knowledge sharing session will be held this coming sunday...
  • Firefox: Tech writer friendly!
    Firefox has an in-built popup blocker. Firefox saves your screenspace through its tabbed-browsing feature. Firefox allows for opening mult...
  • Engrish!
  • Context Sensitive 'Sticky Notes': Stick a Sticky Note to your Blog!
    Conceptworld's Quick Notes Plus might appear like any other Sticky Notes Plus (QNP) program, but its context-sensitive notes feature is...
  • Writing SI units and symbols
    Quite a few of us do not write the SI units correctly. If you are a Physics or Chemisty student, and still remember what you studied in scho...
  • Finding the voice
    Excerpt from LOUIS MENAND's review of Eats, Shoots & Leaves: The Zero Tolerance Approach to Punctuation” (Gotham; $17.50), by Lynne ...
  • The Personable Manual
    Why do product manuals sound formal and stiff-upper-lipped? Why don’t users read manuals? These questions have haunted the hallowed precinct...
  • Tech-writers – A Necessary Evil
    In a world where accuracy is all important, a lot goes over the head of the dummy. I don't know if it's intellectual snobbery, but p...

Categories

  • conferences
  • contigency design
  • culture
  • design
  • error messages
  • google
  • hall of shame
  • ideas
  • management
  • manual
  • standards
  • stc
  • strategy
  • tools
  • usability
  • writing

Blog Archive

  • ▼  2009 (1)
    • ▼  February (1)
      • The Personable Manual
  • ►  2008 (5)
    • ►  November (1)
    • ►  September (1)
    • ►  May (2)
    • ►  April (1)
  • ►  2007 (7)
    • ►  October (1)
    • ►  August (2)
    • ►  June (1)
    • ►  March (1)
    • ►  January (2)
  • ►  2006 (10)
    • ►  November (2)
    • ►  October (3)
    • ►  September (1)
    • ►  August (3)
    • ►  June (1)
  • ►  2005 (17)
    • ►  December (2)
    • ►  November (1)
    • ►  October (3)
    • ►  September (2)
    • ►  August (3)
    • ►  June (2)
    • ►  May (1)
    • ►  April (2)
    • ►  February (1)
  • ►  2004 (32)
    • ►  December (4)
    • ►  November (1)
    • ►  October (3)
    • ►  September (3)
    • ►  August (2)
    • ►  July (5)
    • ►  June (3)
    • ►  May (1)
    • ►  April (5)
    • ►  March (2)
    • ►  February (1)
    • ►  January (2)
  • ►  2003 (42)
    • ►  December (2)
    • ►  November (3)
    • ►  October (1)
    • ►  September (3)
    • ►  August (7)
    • ►  July (2)
    • ►  June (1)
    • ►  April (4)
    • ►  February (4)
    • ►  January (15)
Powered by Blogger.

About Me

Unknown
View my complete profile