Re: [DOCS] Please Review - Releasing Publican Documentation from Apache CloudStack

2013-04-25 Thread Chip Childers
On Wed, Apr 24, 2013 at 06:20:38PM -0500, Joe Brockmeier wrote:
> While releasing the documentation today I went ahead and wrote up a
> draft on the wiki so that anyone can do this in the future. Please have
> a look and suggest changes (or make them yourself, it's a wiki!) 
> 
> https://cwiki.apache.org/CLOUDSTACK/releasing-docs.html

Thanks Joe...  

What was the part that got you stuck yesterday?  I noticed some buildbot
errors were sent to the commit list.


Re: [DOCS] Please Review - Releasing Publican Documentation from Apache CloudStack

2013-04-25 Thread Joe Brockmeier
On Thu, Apr 25, 2013, at 08:27 AM, Chip Childers wrote:
> On Wed, Apr 24, 2013 at 06:20:38PM -0500, Joe Brockmeier wrote:
> > While releasing the documentation today I went ahead and wrote up a
> > draft on the wiki so that anyone can do this in the future. Please have
> > a look and suggest changes (or make them yourself, it's a wiki!) 
> > 
> > https://cwiki.apache.org/CLOUDSTACK/releasing-docs.html
> 
> Thanks Joe...  
> 
> What was the part that got you stuck yesterday?  I noticed some buildbot
> errors were sent to the commit list.

Damn, you want me to spell out *in public* how I futzed it up? :-)

The actual error was trying an 'svn remove' and then 'svn copy' when
moving the new docs over to the content/docs directory. Instead, it's
better to just copy over the new files using regular *nix cp and svn add
the new files. 

It seemed to get "stuck" on the order of removing/adding files, saying
it couldn't add a file to a location it was removing. I backed it out by
reverting the commits (which svn doesn't make nearly as easy, I'm
writing up a post on this today...) and then redoing everything, then
committing again. 

Best,

jzb
-- 
Joe Brockmeier
j...@zonker.net
Twitter: @jzb
http://www.dissociatedpress.net/


Re: [DOCS] Please Review - Releasing Publican Documentation from Apache CloudStack

2013-04-25 Thread Chip Childers
On Thu, Apr 25, 2013 at 08:50:29AM -0500, Joe Brockmeier wrote:
> On Thu, Apr 25, 2013, at 08:27 AM, Chip Childers wrote:
> > On Wed, Apr 24, 2013 at 06:20:38PM -0500, Joe Brockmeier wrote:
> > > While releasing the documentation today I went ahead and wrote up a
> > > draft on the wiki so that anyone can do this in the future. Please have
> > > a look and suggest changes (or make them yourself, it's a wiki!) 
> > > 
> > > https://cwiki.apache.org/CLOUDSTACK/releasing-docs.html
> > 
> > Thanks Joe...  
> > 
> > What was the part that got you stuck yesterday?  I noticed some buildbot
> > errors were sent to the commit list.
> 
> Damn, you want me to spell out *in public* how I futzed it up? :-)

PEBKAC errors are useful for others to know about... ;-)

> 
> The actual error was trying an 'svn remove' and then 'svn copy' when
> moving the new docs over to the content/docs directory. Instead, it's
> better to just copy over the new files using regular *nix cp and svn add
> the new files. 
> 
> It seemed to get "stuck" on the order of removing/adding files, saying
> it couldn't add a file to a location it was removing. I backed it out by
> reverting the commits (which svn doesn't make nearly as easy, I'm
> writing up a post on this today...) and then redoing everything, then
> committing again. 

Interesting..  Thanks Joe!


Re: [DOCS] Please Review - Releasing Publican Documentation from Apache CloudStack

2013-04-25 Thread Joe Brockmeier
On Thu, Apr 25, 2013, at 08:55 AM, Chip Childers wrote:
> PEBKAC errors are useful for others to know about... ;-)

http://www.dissociatedpress.net/blog/2013/04/25/reverting-an-svn-commit/

There ya go. 

Best,

jzb
-- 
Joe Brockmeier
j...@zonker.net
Twitter: @jzb
http://www.dissociatedpress.net/