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