Re: [gentoo-dev] Projects and simple guides

2006-01-13 Thread Ciaran McCreesh
On Tue, 10 Jan 2006 15:12:27 -0600 Lance Albertson [EMAIL PROTECTED] wrote: | Last I knew, its not a simple task for generating those nice looking | html pages that ciaranm made a while back for the developer docs. | When I asked him about (he can probably provide more detail), It took | a lot of

Re: [gentoo-dev] Projects and simple guides

2006-01-10 Thread Donnie Berkholz
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Lance Albertson wrote: | Donnie Berkholz wrote: | |Lance Albertson wrote: || What if instead of having proj/en we did herd/en on www? Of course, that || doesn't help the whole GuideXML is hard bit. I like the idea of using || RST, but it doesn't seem

Re: [gentoo-dev] Projects and simple guides

2006-01-10 Thread Jan Kundrát
Donnie Berkholz wrote: Sven Vermeulen wrote: | We have already received many bugs for documentation in /proj/* which is | not GDPs. I had no issue with this as I hoped this would be a transient | state where the documentation is eventually handed over to the GDP so that | both the project

Re: [gentoo-dev] Projects and simple guides

2006-01-10 Thread Chris Gianelloni
On Tue, 2006-01-10 at 01:17 -0600, Lance Albertson wrote: I understand the block was lifted for projects, but that doesn't mean herds should all should fit underneath proj/. I think we should open up a similar space just for herds. I think that would be a wonderful idea. What would we do

Re: [gentoo-dev] Projects and simple guides

2006-01-10 Thread Sven Vermeulen
Chris Gianelloni said: Really, I think that the number of bugs the GDP gets is probably fairly minimal for project-based documentation. Perhaps we could have something added to the project dtd that adds a little blurb at the bottom to file bugs for project documentation against the project

Re: [gentoo-dev] Projects and simple guides

2006-01-10 Thread Lance Albertson
Chris Gianelloni wrote: On Tue, 2006-01-10 at 01:17 -0600, Lance Albertson wrote: I understand the block was lifted for projects, but that doesn't mean herds should all should fit underneath proj/. I think we should open up a similar space just for herds. I think that would be a wonderful

Re: [gentoo-dev] Projects and simple guides

2006-01-10 Thread Aron Griffis
Grant Goodyear wrote: [Tue Jan 10 2006, 11:09:15AM EST] As an aside, it's ciarnanm has already put work in on developing an RST to guidexml converter, so I wouldn't worry too much about RST not scaling. Could that be used dynamically on the server? The last time I was familiar with the

Re: [gentoo-dev] Projects and simple guides

2006-01-10 Thread Stuart Herbert
Hi Donnie, On 1/10/06, Donnie Berkholz [EMAIL PROTECTED] wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Donnie Berkholz wrote: | I don't want to get into the habit of inconsistency and finding herds in | two different locations. To clarify, add an either onto the end of that. |

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Diego 'Flameeyes' Pettenò
On Monday 09 January 2006 03:14, Marius Mauch wrote: Find a nice place in www.gentoo.org/proj/ Okay that's what I try to do most of the time, in this specific case, I'm probably going to ask for space to qa project (as fixing --as-needed problems or parallel make issues and such is imho

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Aron Griffis
Brian Harring wrote:[Sun Jan 08 2006, 09:16:36PM EST] Regardless, (imo) it's already been laid out why guideXML'ifying everything doesn't totally work. Three reasons... A) bit of work required just to jot down a quick list of this is broke, fix it that's going to be thrown out 2 weeks

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Tom Martin
On Mon, 9 Jan 2006 09:34:22 -0500 Aron Griffis [EMAIL PROTECTED] wrote: Brian Harring wrote: [Sun Jan 08 2006, 09:16:36PM EST] Regardless, (imo) it's already been laid out why guideXML'ifying everything doesn't totally work. Three reasons... A) bit of work required just to jot down a

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Brian Harring
Sending this to the ml, tom already has heard the reasons but throwing them out for others to comment on... On Mon, Jan 09, 2006 at 04:47:57PM +, Tom Martin wrote: I realize this doesn't address the *rest* of what you said, though... snip These little 'howtos' are potentially very

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Tom Martin
On Mon, 9 Jan 2006 16:47:57 + Tom Martin [EMAIL PROTECTED] wrote: On Mon, 9 Jan 2006 09:34:22 -0500 Aron Griffis [EMAIL PROTECTED] wrote: Brian Harring wrote:[Sun Jan 08 2006, 09:16:36PM EST] Regardless, (imo) it's already been laid out why guideXML'ifying everything

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Grant Goodyear
Diego 'Flameeyes' Pettenò wrote: [Sun Jan 08 2006, 11:59:40AM CST] I originally thought of putting it on my devspace, but using GuideXML there is a bit tricky, at least for me (as xsltproc seems to refuse working on the pure xml directly). I actually prefer devspace for these sorts of docs.

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Jan Kundrát
Grant Goodyear wrote: Again, I like devspace for these things. Of course, particularly useful docs would likely be adopted by the GDP (with the permission of the author, of course). Thinking about legal issues (and about tracking all contributors among developers) - please use CC-BY-SA [1]

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Lance Albertson
Grant Goodyear wrote: Diego 'Flameeyes' Pettenò wrote: [Sun Jan 08 2006, 11:59:40AM CST] I originally thought of putting it on my devspace, but using GuideXML there is a bit tricky, at least for me (as xsltproc seems to refuse working on the pure xml directly). I actually prefer devspace

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Tom Martin
On Mon, 9 Jan 2006 18:11:42 +0100 Diego 'Flameeyes' Pettenò [EMAIL PROTECTED] wrote: And IIRC ciaranm said it took quite a while to render the devmanual from RST to HTML, would be difficult to sync hourly then. The devmanual has an an enormous number of links, citations and cross references.

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Diego 'Flameeyes' Pettenò
On Monday 09 January 2006 21:04, Tom Martin wrote: The devmanual has an an enormous number of links, citations and cross references. I'd imagine that's what really takes time to generate. For things like this, it would be very fast. Might be good to test moinmoin's RST support then. -- Diego

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Sven Vermeulen
On Sun, Jan 08, 2006 at 06:45:01PM +, Luis Medinas wrote: We could start a public wiki displaying all herds and projects. It would be great to add some low level docs, herds/project goals, ideas and so. Even the users could be allowed to edit and share information. I would personally

Re: [gentoo-dev] Projects and simple guides

2006-01-09 Thread Donnie Berkholz
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Lance Albertson wrote: | What if instead of having proj/en we did herd/en on www? Of course, that | doesn't help the whole GuideXML is hard bit. I like the idea of using | RST, but it doesn't seem very scalable at this time. Maybe, instead of | that,

[gentoo-dev] Projects and simple guides

2006-01-08 Thread Diego 'Flameeyes' Pettenò
Okay let's forget the flames and talk about something related to practical development today :) As people reading my blog might already know, I've been experimenting with --as-needed LDFLAG in the past days. It seems pretty stable when you don't have GNOME installed (as many libraries from

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Renat Lumpau
On Sun, Jan 08, 2006 at 06:59:40PM +0100, Diego 'Flameeyes' Petten? wrote: GDP might be the place where to put them, but as they are mainly developer-oriented, they might be better accessed directly by devs (at least for the first steps until they are drafts). What people think about this?

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Lance Albertson
Brian Harring wrote: On Sun, Jan 08, 2006 at 06:07:48PM +, Renat Lumpau wrote: On Sun, Jan 08, 2006 at 06:59:40PM +0100, Diego 'Flameeyes' Petten? wrote: GDP might be the place where to put them, but as they are mainly developer-oriented, they might be better accessed directly by devs (at

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Lance Albertson
Luis Medinas wrote: On Sun, 2006-01-08 at 10:31 -0800, Brian Harring wrote: On Sun, Jan 08, 2006 at 06:07:48PM +, Renat Lumpau wrote: On Sun, Jan 08, 2006 at 06:59:40PM +0100, Diego 'Flameeyes' Petten? wrote: GDP might be the place where to put them, but as they are mainly

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Luis Medinas
On Sun, 2006-01-08 at 12:54 -0600, Lance Albertson wrote: Devwiki is effectively inaccesable to non gentoo folks (whether in access, or in navigating the beast), thus it's a no go. Any docs generated should be googable imo. We could start a public wiki displaying all herds and

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Luis Medinas
On Sun, 2006-01-08 at 13:31 -0600, Lance Albertson wrote: Indeed it's GDP area but to expose project goals, status and low level docs isn't even related with GDP. We can't maintain the high level of docs like GDP does and it's not even your goal. I think the public wiki idea will improve

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Alec Warner
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Lance Albertson wrote: Luis Medinas wrote: On Sun, 2006-01-08 at 12:54 -0600, Lance Albertson wrote: snip snip I had thought about creating some kind of a site like this, but not necessarily in a wiki form. I don't like the idea of letting

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Stuart Herbert
On Sun, 2006-01-08 at 12:54 -0600, Lance Albertson wrote: We could start a public wiki displaying all herds and projects. It would be great to add some low level docs, herds/project goals, ideas and so. Even the users could be allowed to edit and share information. Anything like that will

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Marius Mauch
On Sun, 8 Jan 2006 18:59:40 +0100 Diego 'Flameeyes' Pettenò [EMAIL PROTECTED] wrote: I originally thought of putting it on my devspace, but using GuideXML there is a bit tricky, at least for me (as xsltproc seems to refuse working on the pure xml directly). So I was thinking if we had a way

Re: [gentoo-dev] Projects and simple guides

2006-01-08 Thread Brian Harring
On Sun, Jan 08, 2006 at 11:30:16PM +, Stuart Herbert wrote: On Sun, 2006-01-08 at 12:54 -0600, Lance Albertson wrote: We could start a public wiki displaying all herds and projects. It would be great to add some low level docs, herds/project goals, ideas and so. Even the users could