Proposal: Technical Communication
NOTE: The site name has changed from "Documentation" to "Technical Communication"
I'd like for people to discuss the site description here.
Edit2 (site name changed from "Documentation" to "Technical Communication"):
Since the name of the site has changed, there have been a variety of proposals for changing the description. Here's what I've come up with:
Edit3 (3/19/17): After waiting for feedback/votes, I have decided to implement the above description.
Documentation is the best of all the not-quite-right options.
I like "Tech Writing," personally, because I think of myself as a "Technical Writer," not a "Documentation Writer" (or "Documentarian" - yikes). But lots of technical communication is not primarily written.
There are two problems I see with "Technical Communication":
There really needs to be an SE community/site focused on the (many, many) problems and issues of documentation. This include writing (style, grammar, structure), tooling (authoring, editing, publishing), and process ("DocOps"). Calling it "documentation" is the best way to communicate that this is the primary focus.
Just a few thoughts, which (after writing them) feel a bit like I'm bikeshedding...
I know a lot of people who write docs for a living. Most of them go by the title "Technical Writers." I don't know any of them who call themselves "information developers." Many are "technical communicators" on their resume but "technical writers" in person.
Also, because of where I live and my resume/background, I get several calls a day from recruiters trying to find people to write docs. 99/100 of these call the job "Technical Writer."
My opinion is that "technical writers" should be the first thing on this list. At the very least "writer" should not be orphaned without the modifier "technical" in front of it ("tech writer" is a thing in particular, and novelists are not likely interested in this SE).
If I had written the description, it would be:
NOTE: At the time I'm writing this answer, the site description is currently:
As an outgrowth of discussion in the comment thread here, I propose to revise it to something like (additions emphasized, deletions struck out):
I feel that the title of "Documentation" is perfect. It is succsinct and descriptive. It is more inclusive than anything with "writer" in it could ever be.
The description of the site seems well formated and inclusive, including the programmers and engineers (the creators of that which needs documentation). To avoid the trap of thinking that documentation is only written, the description could be slightly modified to:
For the site to succeed it will need to attract a body of experienced people to provide answers to questions, and questions that will interest those experts, and entice them to spend time sharing their knowledge and experience. While the technical aspects of writing might be better dealt with in the Writers SE space, or even the English Languague and Usage SE space, this site will also have to deal with that, especially as it is often applied differently for documentation than for literature and reports.
The site name and description needs to suggest to potential experts, and querants, that this is the place to spend their time and energy. As insight into the importance of the questions, I recommend the SO blog post about Optimizing For Pearls, Not Sand.
With the name change to Technical Communication, the site will need some changes to the site description. After stewing over it for a while, this is my contribution to the possible new version.
I realize it is very wordy, and I'm sure there are better minds than mine that can condense that into something useful. I've already trimmed it as far as my skills will take it.
Note: About half of that is based on the entry for Technical Writers in the U.S. Dept. of Labor, Bureau of Labor Statistics, Occupational Outlook Handbook.
Oh, I don't know...What about "TechDocs"? I'm no good at coming up with names. I like the thought of something catchy, though.
I suggest a new name for the group: Information Architecture
"Documentation" is very specific and is quite limited in scope, because it seems to be related to writing. I suggest to open the scope and simply name it "Information Architecture". So a "Documentation" is a result of an "Information Architecture".
Not sure whether it's ironic or hilarious, but the answer to "What should we name it" has been in your description the whole time- Technical Documentation**.
Simply calling it documentation is workable, unless of course you consider that I could be some conservationist who's working on documenting the mating habits of the Cuculidae (Cuckoo bird). How are you going to react to me asking about long & short outlines or how best to keep readers enticed by my documented findings? Personally I'm sure there would be ignorant criticisms and plenty of down-votes, but eventually someone would kindly explain to me that "this site is for documenting "technical stuff". At which point I would likely reply with "well why didn't you call it technical Documentation then?". "Where do I go now?"
I suppose I could submit a new documentation site idea, but I'd likely be told that a site called Documentation already exists. Afterwards I get upset and frustrated and yadda yadda you get the idea. Just be cognizant that documenting and documentation are not byproducts of the technical world, they apply to many things. If your intention is to have technical people discussing "Technical Documentation", then your site name needs to reflect your intent. Just my two cents, before taxes.
All that being said, I have two semi-related points I would like to address:
I wrote a quick, yet adequate explanation of Information Architecture the other day. Here's a link for anyone interested: https://ux.stackexchange.com/a/104148/22680