Comments on: Top 50 technical writers on the web + Xfce and Xubuntu doc updates http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/ user help, free and open source Sat, 21 Aug 2010 16:26:55 +0000 hourly 1 http://wordpress.org/?v=3.0.1 By: jim http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/comment-page-1/#comment-259 jim Thu, 12 Nov 2009 04:02:27 +0000 http://j1m.net/?p=123#comment-259 Hi Elizabeth, I'll look forward to seeing you at UDS. If you would like to share what you talk about with regards to getting started with docs, I'd love to see it. Thanks! Jim Hi Elizabeth, I’ll look forward to seeing you at UDS. If you would like to share what you talk about with regards to getting started with docs, I’d love to see it. Thanks!

Jim

]]> By: Elizabeth Krumbach http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/comment-page-1/#comment-240 Elizabeth Krumbach Thu, 15 Oct 2009 03:53:40 +0000 http://j1m.net/?p=123#comment-240 I'm doing a talk this weekend at a local conference on contributing to open source projects and one of the areas I highlight is getting involved with documentation. It's the first real contribution I made to an open source project, and I work hard in my talk to explain how vital it is and how easy it is to get involved as a point of entry when you start getting involved with F/OSS. Hopefully my blurb with do it's part in making documentation cool again :) I'm thrilled to hear you'll be working on the 4.8 documentation, I've been a long-time committed XFCE4 user and improvements everywhere are exciting. See you at UDS! I’m doing a talk this weekend at a local conference on contributing to open source projects and one of the areas I highlight is getting involved with documentation. It’s the first real contribution I made to an open source project, and I work hard in my talk to explain how vital it is and how easy it is to get involved as a point of entry when you start getting involved with F/OSS. Hopefully my blurb with do it’s part in making documentation cool again :)

I’m thrilled to hear you’ll be working on the 4.8 documentation, I’ve been a long-time committed XFCE4 user and improvements everywhere are exciting.

See you at UDS!

]]> By: Janet Swisher http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/comment-page-1/#comment-237 Janet Swisher Tue, 13 Oct 2009 15:49:49 +0000 http://j1m.net/?p=123#comment-237 I agree that the lack of open source doc writers on that list points up the lack of overlap and interchange between the open source and commercial tech writing communities. Both groups have much that they could learn from each other, but may not realize it. I've been neglecting my blog lately since starting a new job. Your post helped me realize that I could at least start giving some link love to open source tech writers, to start spreading some awareness of them to commercial tech writers. I agree that the lack of open source doc writers on that list points up the lack of overlap and interchange between the open source and commercial tech writing communities. Both groups have much that they could learn from each other, but may not realize it.

I’ve been neglecting my blog lately since starting a new job. Your post helped me realize that I could at least start giving some link love to open source tech writers, to start spreading some awareness of them to commercial tech writers.

]]> By: Tweets that mention notes from the mousepad » Blog Archive » Top 50 technical writers on the web + Xfce and Xubuntu doc updates -- Topsy.com http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/comment-page-1/#comment-236 Tweets that mention notes from the mousepad » Blog Archive » Top 50 technical writers on the web + Xfce and Xubuntu doc updates -- Topsy.com Tue, 13 Oct 2009 03:52:18 +0000 http://j1m.net/?p=123#comment-236 [...] This post was mentioned on Twitter by Planet Ubuntu and Abhishek. Abhishek said: RT @planetubuntu:Jim Campbell: Top 50 technical writers on the web + Xfce and Xubuntu doc updates: site &#.. http://bit.ly/lUMtK [...] [...] This post was mentioned on Twitter by Planet Ubuntu and Abhishek. Abhishek said: RT @planetubuntu:Jim Campbell: Top 50 technical writers on the web + Xfce and Xubuntu doc updates: site &#.. http://bit.ly/lUMtK [...]

]]> By: Roger http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/comment-page-1/#comment-235 Roger Tue, 13 Oct 2009 03:35:44 +0000 http://j1m.net/?p=123#comment-235 As a developer I take a slightly different view. The software should be so perfect that it requires no administration or configuration. The admin/config should be so perfect that no documentation is needed. The documentation should be so perfect that no support is needed. Of course nothing is perfect, but a certain part (and IMNSHO a large part) of documentation is really treating the symptoms of usability in the software and its admin/config. I would really see more of a focus on why pieces of documentation are being written and efforts to help ensure they don't need to be written in the first place. As a developer I take a slightly different view. The software should be so perfect that it requires no administration or configuration. The admin/config should be so perfect that no documentation is needed. The documentation should be so perfect that no support is needed.

Of course nothing is perfect, but a certain part (and IMNSHO a large part) of documentation is really treating the symptoms of usability in the software and its admin/config. I would really see more of a focus on why pieces of documentation are being written and efforts to help ensure they don’t need to be written in the first place.

]]> By: jim http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/comment-page-1/#comment-234 jim Tue, 13 Oct 2009 03:24:29 +0000 http://j1m.net/?p=123#comment-234 Heh... I forgot that it came up in discussions at WOSDOCS. http://identi.ca/conversation/5956670#notice-5956731 Heh… I forgot that it came up in discussions at WOSDOCS.

http://identi.ca/conversation/5956670#notice-5956731

]]> By: Paul Cutler http://j1m.net/2009/10/12/top-50-technical-writers-on-the-web-xfce-and-xubuntu-doc-updates/comment-page-1/#comment-233 Paul Cutler Tue, 13 Oct 2009 02:46:44 +0000 http://j1m.net/?p=123#comment-233 I should have made a rule that what I said in Owen Sound stays in Owen Sound! (Just kidding). I should have made a rule that what I said in Owen Sound stays in Owen Sound! (Just kidding).

]]>