| 1 |
On Sunday 08 January 2006 18:59, Diego 'Flameeyes' Pettenò wrote: |
| 2 |
> Okay let's forget the flames and talk about something related to |
| 3 |
> practical development today :) |
| 4 |
Sigh ok no practical development at this come out as a discussion/flame again. |
| 5 |
|
| 6 |
What I was thinking of is _not_: |
| 7 |
- a wiki writable by users; |
| 8 |
- a CVS writable by non-devs; |
| 9 |
- a replacement for GuideXML (I like it); |
| 10 |
- a way to replace GDP (I was thinking of dev-level documentation); |
| 11 |
|
| 12 |
What I was thinking was instead: |
| 13 |
- a place where things can be drafted up before GDP submission if they want to |
| 14 |
handle dev docs, too; |
| 15 |
- a place where devs can put their own dev guides, without changing the style |
| 16 |
of the site from the one in main Gentoo site; |
| 17 |
- a place that does not require the strict belonging to a project to put |
| 18 |
guides into. |
| 19 |
|
| 20 |
I like GuideXML, so I have no problem with writing small-to-medium guides with |
| 21 |
it, RST would be fine, too, but I don't want it to be plain text or ViewCVS |
| 22 |
only, GuideXML is in style with the rest of the site and it has printable |
| 23 |
version available, and it's Googlable. ViewCVS is too "raw" for user viewing, |
| 24 |
and there might be users interested in those guides. And IIRC ciaranm said it |
| 25 |
took quite a while to render the devmanual from RST to HTML, would be |
| 26 |
difficult to sync hourly then. |
| 27 |
|
| 28 |
-- |
| 29 |
Diego "Flameeyes" Pettenò - http://dev.gentoo.org/~flameeyes/ |
| 30 |
Gentoo/ALT lead, Gentoo/FreeBSD, Video, AMD64, Sound, PAM, KDE |
Archives