[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-scm-interest
Subject:    Re: [Kde-scm-interest] scripty questions
From:       Thiago Macieira <thiago () kde ! org>
Date:       2009-05-24 8:24:13
Message-ID: 200905241024.24848.thiago () kde ! org
[Download RAW message or body]

[Attachment #2 (multipart/signed)]


Chani wrote:
>> If you really need to clone a specific directory, you have two
>> solutions: 1. Make the directory a separate repository and have it as
>> a submodule in the parent repository. Cons: Complex and not really
>> easy to use. 2. Don't use git for that directory; just fetch a tar.gz
>> via HTTP. Cons: Should be obvious. Not really a solution.
>
>or the ugly-hack solution:
>since scripty has to download all the modules anyways, have it copy the
> git doc folders into a separate folder, make that available online, and
> have the update_xml script rsync it or download a tgz of it or
> something. :/
>
>none of these are good solutions, really.

My suggestion is that we move the documentation out of each module's 
repository.

The simplest solution is that there is one repository for documentation, 
which matches l10n-kde4/documentation today. Anybody who wishes to 
translate documentation or write documentation has to clone this 
repository.

The other solution is that there be a submodule for documentation per 
module. This submodule is linked to each module and from the equivalent of 
l10n-kde4.

The first solution represents the least diskspace used by translators (Git 
repository compression works best when you have fewer repositories). 
However, that is a lot more diskspace for developers when writing the 
documentation itself. 

It's more hassle as well when trying to release an app, since you have to 
somehow mark which commit in the documentation matches your release as 
well as copy those files into your package.
-- 
  Thiago Macieira  -  thiago (AT) macieira.info - thiago (AT) kde.org
    PGP/GPG: 0x6EF45358; fingerprint:
    E067 918B B660 DBD1 105C  966C 33F5 F005 6EF4 5358

["signature.asc" (application/pgp-signature)]

_______________________________________________
Kde-scm-interest mailing list
Kde-scm-interest@kde.org
https://mail.kde.org/mailman/listinfo/kde-scm-interest


[prev in list] [next in list] [prev in thread] [next in thread]