Documentation proposal

[Jannis Pohlmann]

On Mon, 4 May 2009 01:07:48 -0700
"Brian J. Tarricone" <brian at tarricone.org> wrote:

> On Mon, 4 May 2009 08:39:56 +0200 Nick Schermer wrote:
> 
> > Previously I was thinking a separate package for docs was a good
> > idea, but noadays I'm more or less against this (because of the
> > modularity it should be possible for people to use a single
> > component without being bothered with the rest of the
> > documentation).
> 
> Yeah, that was my main issue as well.  Some people do use xfwm4 (for
> example) outside of Xfce, so installing *all* of the Xfce docs just to
> get xfwm4 docs might be silly.
> 
> > On the other hand I can understand all the docs in a single repo are
> > easier to maintain, which is at this point the biggest issue. So
> > maybe we can put all the docs in 1 git module and we use a hook
> > inside a module (thunar, panel, xfwm4) to include the (translated)
> > html when running make dist.
> 
> Something like that... only maybe better might be to -- as you say --
> have all the docs in one git repo, but still distribute them in each
> app module as we do today.  Should be simple to do with git
> submodules, right?  That way people who want to improve the docs only
> need to look at one module, but the docs still end up in each
> individual module for distribution.

Can you explain that for me? I don't know what git submodules are.

  - Jannis
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
URL: <http://mail.xfce.org/pipermail/xfce4-dev/attachments/20090504/91acaf64/attachment.pgp>