incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "robert burrell donkin" <robertburrelldon...@gmail.com>
Subject Re: [suggestion] making documentation management more lightweight
Date Sun, 06 May 2007 11:23:28 GMT
On 5/5/07, Leo Simons <mail@leosimons.com> wrote:
> Jo!
>
> The whole jira-patch-commit workflow for the documentation seems
> annoying. At least it annoys me -- in particular the patches don't
> show up in my email so I have to visit jira which I try and avoid as
> much as possible :-).
>
> Suggestions:
>
> 1) create
>
>     http://svn.apache.org/repos/asf/incubator/public/staging
>
>     writeable by *all* committers
>
>     svn cp http://svn.apache.org/repos/asf/incubator/public/trunk \
>         http://svn.apache.org/repos/asf/incubator/public/staging
>     vi infrastructure/trunk/subversion/authorization/asf-authorization
>     svn commit infrastructure/trunk/subversion/authorization/asf-
> authorization

ok

> 2) create an svn:externals on
>
>        http://svn.apache.org/repos/asf/incubator/public/trunk/site-
> publish
>
>     like this
>
>       website-staging http://svn.apache.org/repos/asf/incubator/
> public/staging/site-publish
>
>     so that you can see the work-in-progress at
>
>       http://incubator.apache.org/website-staging/

perhaps http://incubator.apache.org/~website-draft-staging/ would be better

> 3) instead of sending documentation patches, people who are helping
>     with the documentation work on the staging branch

ok

> 4) set up svnmerge.py for staging/ and trunk/
>     * see http://www.orcaware.com/svn/wiki/Svnmerge.py
>     * make sure to block the revision from step #2!

looks good

> 5) propose documentation changes on the mailing list
>     * get diffs
>
>       cd incubator/trunk
>       svnmerge.py --bidirectional diff > ~/staging-diffs.txt
>       # or use -r to get only a few revisions
>
>     * send diff to mailing list for discussion and lazy
>       consensus approval

ok

> 6) merge
>
>     cd incubator/trunk
>     svnmerge.py --bidirectional avail
>     svnmerge.py --bidirectional # or use -r12345,...
>     svn commit -F svnmerge-commit-message.txt
>     cd ../staging
>     svnmerge.py
>     svn commit -F svnmerge-commit-message.txt

bit uncertain whether a single set of drafts will work but willing to
give it a go

so, ok by me

- robert

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Mime
View raw message