Gentoo Archives: gentoo-doc

From: "Matthew Summers; CEO
To: Brett Meadors <MEADORS@××××××××××××××××.edu>
Cc: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Helping Out
Date: Tue, 05 Aug 2008 19:13:52
Message-Id: 4898A719.80104@liquidustech.com
In Reply to: RE: [gentoo-doc] Helping Out by Brett Meadors
1 Brett Meadors wrote:
2 > Hey Matt, I would be glad to help out in some regard or another, possibly with updating documentation. In concerns with portage, they've been wanting me to help get the documents converted from man pages to Doc-book, so if you have any interest with that, I'd be more than glad to coordinate with you on it.
3 >
4 > Brett Meadors
5 > Student Assistant I
6 > HEHD Technical Support
7 > (864)940-7711
8 >
9 >
10 > -----Original Message-----
11 > From: Matthew Summers; CEO, Liquidus Tech, LLC [mailto:matthew.summers@××××××××××××.com]
12 > Sent: Friday, July 04, 2008 12:38 PM
13 > To: gentoo-doc@l.g.o
14 > Cc: Brett Meadors
15 > Subject: Re: [gentoo-doc] Helping Out
16 >
17 > Josh Saddler wrote:
18 >> Brett Meadors wrote:
19 >>> I have been reading up and begun helping out with the portage project
20 >>> with their documentation, and I would really like to get involved with
21 >>> the Documentation team as both a active contributor and editor. Please
22 >>> let me know what I can do to help, what projects need some attention,
23 >>> and how I can be of help.
24 >> Speaking of Portage . . . one of the things with Portage 2.2, which is
25 >> now in ~arch, is that our Portage Handbook and related documentation in
26 >> gentoo.org/doc/en/ will need to be updated. 2.2, once stable, will give
27 >> everyone capabilities like user-defined sets, new behavior of the world
28 >> and system sets, FEATURES like preserve-rebuild (or whatever they ended
29 >> up calling it), and more.
30 >>
31 >> Though I've heard via third parties that some of the Portage developers
32 >> plan to help out with updating this documentation, we haven't heard from
33 >> them yet. So, if you want to, head on over to the GDP page, at
34 >> http://gdp.gentoo.org. We have resources there on how to write GuideXML.
35 >> Armed with this knowledge, you'd be ready to tackle the updates needed
36 >> for the Portage handbook, which starts here:
37 >>
38 >> http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=2
39 >>
40 >> Lots and lots of stuff to jump into. Or, if you'd rather take a break
41 >> from Portage docs, just jump into bugzilla (http://bugs.gentoo.org) and
42 >> search for open Documentation and Docs-user bugs that are assigned
43 >> to/CCed to docs-team@g.o. Just poke at whatever you want to do;
44 >> any and all help is welcome. Happy hunting.
45 >>
46 > Josh,
47 >
48 > I was told to talk to you about gentoo related graphics. I have a hardened badge I made for our main site, that might be cool to include on
49 > the graphics page, since there are no hardened badges that I have seen. Here's a direct link.
50 > http://www.liquidustech.com/media_files/images/powered_by_hardened_gentoo_badge.png
51 >
52 > Still could use some more work, but its a good start.
53 >
54 >
55 > Brett,
56 >
57 > My company has two grad students technical writing interns working on Gentoo docs this summer. I know they would love some additional
58 > assistance. Currently we are working on SAN Multipath doc with Joshua Jackson (tsunam), some hardened gentoo docs, bluetooth doc updates,
59 > autotools doc creation, and himerge (portage gui) docs. If any of these sound interesting, please contact me. There is aways room for more
60 > too. I would personally like to be a part of updating the portage docs.
61 >
62 > Best Regards,
63 >
64 > Matthew Summers
65
66 Brett,
67
68 Any work on this? I was able to get the man pages from trunk. Starting
69 to format as GuideXML, well the interns are. Let me know if you still
70 want to work on this with us, or if you have some work completed.
71
72 Thanks,
73 Matt
74
75 --
76 Matthew W. Summers
77
78 Chief Executive Officer & Systems Engineer
79 Liquidus Tech, LLC
80 matthew.summers@××××××××××××.com
81 www.liquidustech.com