I'd like to put Python devguide to devmanual. For that reason, I'd like to request an improvement in devmanual syntax. I'd like to be able to create a sub-sections/boxes with information dedicated to a particular group of people. Mostly like: Section --------- Normal stuff. +-------- | python.eclass differences | ... +-------- +------- | Rationale | ... +------- with each 'python.eclass differences' being a box of one color, and 'Rationale' of another, so that people could be able to find them easily within various sections.
I certainly don't have the knowledge to do such thing. So lets hope someone in the devmanual@ can do that or you can provide a patch of course :). I will cc a couple of people that may know about these things.
No need to CC me, I'm on devmanual@. I still say we should migrate devmanual to rst + sphinx, and then with the proper stylesheet this should be no problem. I don't know (and don't care to find out) how to do it with the legacy xml system.
(In reply to comment #2) > I still say we should migrate devmanual to rst + sphinx, and then with the > proper stylesheet this should be no problem. I don't know (and don't care to > find out) how to do it with the legacy xml system. +1. Is there an agreement over that?
(In reply to comment #3) > (In reply to comment #2) > > I still say we should migrate devmanual to rst + sphinx, and then with the > > proper stylesheet this should be no problem. I don't know (and don't care to > > find out) how to do it with the legacy xml system. > > +1. Is there an agreement over that? no as far as I know
As long as somebody feels like doing the work in full, I don't care which format it is going to be migrated to, but it really has to be migrated. I started with DocBook, but a few years after using it I'm skeptical myself (okay it works nicely for eBook building but it's a lot of work for that anyway). I haven't tried/looked at Sphinx yet, and I have a personal dislike for the original RST format, but if it's an improvement, I'd say go for it. Just please don't name all the files "text.rst".
The theme has changed recently. So I am marking this as obsolete. If the current theme does not satisfy you, re-open the bug