Hi all:
My name is Aaron Bowman.
I am located in Connecticut, USA, and work as the technology manager for a small group of medical practices.
I have been using Linux at home for a number of years, and have decided that it was time that I find a way to give back to the community. I originally started with downloaded floppies of Debian and Slackware, eventually settling on Red Hat 5.0. Around RH7 I began trying out other distributions again, but returned to Red Hat each time. In short, I have used every major release of Red Hat and Fedora since RH 5.0, and just recently moved up to FC6 (yeah, finally got wireless to work).
I am not a power user, nor am I a programmer. I have done very small projects in VB and C++ on Win32; I have worked in PHP, HTML, and SQL in Linux. I have played with Java, Mono (C#), JavaScript, SGML, XML, COBOL, Perl, and LaTeX. Alas, I have only played, but would like to do more.
Earlier this month I had the opportunity to go to FUDCon in Boston; I attended Paul's session on Doc Tools. If I understood the discussion correctly, the goal is for all documentation to be stored in XML, with a static web interface, an editable wiki interface, and of course CVS access. Currently the wiki is not stored in XML and it will need to be converted. I would like to help with the conversion of the documentation in the wiki to XML.
I guess the best place to start for now is the following:
https://www.redhat.com/archives/fedora-docs-list/2006-November/msg00140.html
I would appreciate guidance and instruction on how to be most useful to the project.
On Mon, 2007-02-12 at 15:20 -0500, Griff 5watt wrote:
Hi all:
My name is Aaron Bowman.
Hi Aaron, welcome, and thanks for making the trip from Connecticut to the FUDCon; sounds like it was worth it?
I am located in Connecticut, USA, and work as the technology manager for a small group of medical practices.
I have been using Linux at home for a number of years, and have decided that it was time that I find a way to give back to the community. I originally started with downloaded floppies of Debian and Slackware, eventually settling on Red Hat 5.0. Around RH7 I began trying out other distributions again, but returned to Red Hat each time. In short, I have used every major release of Red Hat and Fedora since RH 5.0, and just recently moved up to FC6 (yeah, finally got wireless to work).
I am not a power user, nor am I a programmer. I have done very small projects in VB and C++ on Win32; I have worked in PHP, HTML, and SQL in Linux. I have played with Java, Mono (C#), JavaScript, SGML, XML, COBOL, Perl, and LaTeX. Alas, I have only played, but would like to do more.
Sounds great, we can definitely use more technologists with the desire to hack. There really is no limit to the coolness we can cook up. I see you haven't done Python, yet ... now is probably a good time.
Paul had a good link for an online book, and the URL or details escape me ...
Earlier this month I had the opportunity to go to FUDCon in Boston; I attended Paul's session on Doc Tools. If I understood the discussion correctly, the goal is for all documentation to be stored in XML, with a static web interface, an editable wiki interface, and of course CVS access. Currently the wiki is not stored in XML and it will need to be converted. I would like to help with the conversion of the documentation in the wiki to XML.
I guess the best place to start for now is the following:
https://www.redhat.com/archives/fedora-docs-list/2006-November/msg00140.html
Right now our efforts on getting Wiki to XML is focused on Python code written for the Moin Moin Wiki as part of last year's Google Summer of Code. A recent post on this subject requesting coding and package maintenance was here:
http://www.redhat.com/archives/fedora-infrastructure-list/2007-February/msg0...
What is best for you to do? It depends on your interest ...
If you are interested in working on the toolchain, I suggest you first get a good handle on what we are doing. You can see everything explicitly in the 'docs-common' and 'example-tutorial' modules:
http://fedoraproject.org/wiki/DocsProject/CvsUsage#Anonymous-CVS
(You can also pursue getting write access to the CVS, in parallel.)
If you are interested in generating content, there are specific guides that need finishing or updating for Fedora 7. In this case, you would want to pick one or more amongst new end-user, administrator, or power-user guides.
(sending now :)
- Karsten
On Mon, 2007-02-12 at 18:57 -0800, Karsten Wade wrote:
On Mon, 2007-02-12 at 15:20 -0500, Griff 5watt wrote:
I am not a power user, nor am I a programmer. I have done very small projects in VB and C++ on Win32; I have worked in PHP, HTML, and SQL in Linux. I have played with Java, Mono (C#), JavaScript, SGML, XML, COBOL, Perl, and LaTeX. Alas, I have only played, but would like to do more.
Sounds great, we can definitely use more technologists with the desire to hack. There really is no limit to the coolness we can cook up. I see you haven't done Python, yet ... now is probably a good time.
Paul had a good link for an online book, and the URL or details escape me ...
Best Python book ever: http://diveintopython.org/
Hi all:
My name is Aaron Bowman.
Earlier this month I had the opportunity to go to FUDCon in Boston; I attended Paul's session on Doc Tools. If I understood the discussion correctly, the goal is for all documentation to be stored in XML, with a static web interface, an editable wiki interface, and of course CVS access. Currently the wiki is not stored in XML and it will need to be converted. I would like to help with the conversion of the documentation in the wiki to XML.
Welcome to Fedora Docs Project.
I'm sure Paul gave you an excellent orientation.
Here is something I've been working on which I hope will be of value to you:
http://fedoraproject.org/wiki/DocsProject/WorkFlowIdeas
This is a work-in-progress and I appreciate any comments or corrections.
John Babich Volunteer, Fedora Docs Project
On Sun, 2007-02-18 at 11:38 +0300, John Babich wrote:
Here is something I've been working on which I hope will be of value to you:
http://fedoraproject.org/wiki/DocsProject/WorkFlowIdeas
This is a work-in-progress and I appreciate any comments or corrections.
BTW, I saw your "hopes spring eternal" commit comment; glad you are still thinking along these lines. I specifically tried to get conversations together around some of these ideas for FUDCon, but we got overcome by events. :)
From what I've seen, there is a _lot_ of interest in working cross-stream with other projects on our common upstream needs. For example, there is interest from Ubuntu to collaborate on Moin Moin and DocBook. I had a student contact me about a content project that works directly on multiple upstream content sources; the idea there would be a Wiki front-end, etc.
So, keep up the energy, we'll see movement somehow. As we originally thought, driving toward a virtual summit is probably a first great move.
- Karsten