6

This relates to my earlier question: Habits and routines for my first tech writing job

I will be involved with writing documentation for an Android OS business application. Is there an Android style guide for this kind of documentation? I really need to know the standard terminology for User Interface interactions.

Google doesn’t turn up anything. All I find are style guides for other OS’s (e.g. here’s the Apple Publications Style Guide) and the Android User Interface Guidelines which, at first glance, doesn’t seem to have what I’m looking for.

  • Things like swipe, tap, and pinch? – cornbread ninja Mar 27 '12 at 3:13
  • That's right. And do you say "Settings", "Options" or ... something else? Is it the "screen" or the "display"? What should I call that bar that's always at the top of the screen? In the end, I solved my problem by downloading the Android User Manual and just copying the terminology (and style) from there. – Pitarou Mar 27 '12 at 13:30
4

It may not be exactly what you're looking for, but don't discount the Android UI Guidelines site immediately. While it isn't exactly overflowing with information, and it is specifically aimed at the text used within applications, the site does have a Writing Style page.

6 rules, 5 examples. But perhaps the application style could do well translated to documentation?

  • Thanks! I missed that and, yes, it's helpful. Next time somebody tells me that their stuffy corporate jargon looks more "professional" I can point them to this style-guide. – Pitarou Apr 5 '12 at 1:54

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.