[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Doc packages



|| On Sat, 3 Jul 2004 15:52:03 +0200 (CEST)
|| Andreas Tille <tillea@rki.de> wrote: 

at> On Wed, 30 Jun 2004, Otavio Salvador wrote:
>> To me, the doc merge is the right thing to do.
at> While I'm not really convinced I would follow your suggestions but
at> I think we are now facing two problems:

at>    1. Release cycle: I found out that there are periods with more
at>       coding activity and others with mor doc editing activity. If
at>       we release in one source package we would be forced to release
at>       code and docs at the same moment which is not the best idea, IMHO.

IMHO code and docs NEED be relased together.

If we change some issue in code, this should be updated in docs too.

at>    2. For the projects tree:  I wanted to merge the med-docs package
at>       to SVN.  Now I'm facing the problem, that there is a "docs"
at>       directory existent (which contains the menu helpers).  It would
at>       be very confusing for users to have a docs and a doc directory.

Why not move it to menu/docs/? ;-)

at> While 1. is a problem I do not know a good solution for I think that
at> my idea with the docs directory is generally bad (Brocken At Design).
at> I think if it is connected to the menus we should move this directory
at> to menu.  While doing this move I would like to hear your opinion about
at> creating the menu entries at the target system as I suggested in the
at> last paragraph of the target system

at>  http://people.debian.org/~tille/cdd/ch-technology.en.html#s-meta-package-menus

at> What do you think about this?

Sorry but I don't used yet the menu features of CDD and didn't
understand well the reason to provide the docs.

IMHO, the menu structure possible can be changed to allow a more
featureful use like:

 etc/
        cdd/
                helpers/
                        menu/
                        docs/

In mean time, we probably have more helpers to user like configuration
tools and like so why not include it on helpers directory?

-- 
        O T A V I O    S A L V A D O R
---------------------------------------------
 E-mail: otavio@debian.org      UIN: 5906116
 GNU/Linux User: 239058     GPG ID: 49A5F855
 Home Page: http://www.freedom.ind.br/otavio
---------------------------------------------
"Microsoft gives you Windows ... Linux gives
 you the whole house."

Attachment: pgpUNQ7hzcUY3.pgp
Description: PGP signature


Reply to: