Re: Which repository for documentation contributions?

will kahn-greene <[email protected]> Mon, 18 Oct 2010 18:12:15 -0400
Newsgroups gmane.comp.web.pyblosxom.devel
Message-ID <[email protected]>
The docs in the pyblosxom-web repository are generated from the source
files in the pyblosxom repository.  The pyblosxom repository is the
official central source of all things pyblosxom.

The pyblosxom-web repository is _solely_ for generating the web-site.
All documentation about making changes to pyblosxom or the documentation
talks about the pyblosxom repository.  To my knowledge, none of the
documentation suggests doing anything with the pyblosxom-web repository.
 I think you'd have to go hunting through the pyblosxom-web repository
to reach the question you've reached.

Given that, while I see the issue, I don't think it's something I want
to fix.  Further, the only way to really fix this is to nix the
pyblosxom-web repository.  I'd rather not do that at this time, but if
it turns out this is a point of confusion for many people, then I'm game
in changing how things are organized.

/will


On 10/18/2010 06:04 PM, seanh wrote:
> I was thinking of making a contribution to the pyblosxom docs and
> thought I should clone the repoitory on gitorious, commit my changes to
> my clone and then send a merge request. But both the pyblosxom and  the
> pyblosxom-web repositories contain copies of the documentation. Which
> one should I use?
> 
>>From the commit logs, it looks as if changes have been committed to the
> docs in pyblosxom repo and then later committed in the pyblosxom-web
> repo, which suggests that the pyblosxom repo is the primary source for
> the docs.
> 
> I think this is a problem, there should not be two different sources for
> the docs.

------------------------------------------------------------------------------
Download new Adobe(R) Flash(R) Builder(TM) 4
The new Adobe(R) Flex(R) 4 and Flash(R) Builder(TM) 4 (formerly 
Flex(R) Builder(TM)) enable the development of rich applications that run
across multiple browsers and platforms. Download your free trials today!
http://p.sf.net/sfu/adobe-dev2dev