Improving the documentation process

[Karsten Wade]

On Tue, Feb 10, 2009 at 11:03:33AM -0500, Paul W. Frields wrote:
> On Tue, Feb 10, 2009 at 02:05:08PM -0000, Simon Birtwistle wrote:
> > > I'd swear that you sound like someone who's getting ready to sell us an
> > > automated tool to publish to hosting.  I'm not saying I for one would
> > > turn it down.  But would you care to just go ahead and put it on the
> > > table so we can look at it and figure out the next steps?
> > 
> > There's someone on the Zikula team writing a module to pull your XML
> > documents from source control and publish them into the CMS for displaying
> > to the world.  We're already working on that, in case it hasn't been clear
> > previously.  If this isn't useful or needs to change best to let us know
> > while the script is still in the early stages.
> > 
> > Theoretically you simply write your docbook XML, commit it when you're done
> > and then log into the CMS and hit publish to update the documents.
> > Hopefully there will also be a test option where you can publish in a
> > private location for checking while avoiding publishing a part finished
> > document to the public at large.
> 
> I had read about this module, and just to clarify, I don't want to
> throw a spanner/wrench into anyone's works.  I think this sounds just
> like what Chris is recommending -- a one-click publish to hosting
> solution.  If there are alternate solutions available, happy to see
> them.

With the same conditions that brought Zikula here -- a team of people
need to deploy and maintain a solution, not throw ideas over the wall
to see what sticks.

Since Zikula is right now doing *exactly what Chris is asking for* and
it's going to also give us handy WebUI content management for all
those who prefer that over ... well, however the automated publishing
tool in Chris' vision lets team members decide where and when to
publish ... plus there is momentum over _here_ for Zikula ... uh, what
are we arguing about again?

- Karsten
-- 
Karsten 'quaid' Wade, Community Gardener
http://quaid.fedorapeople.org
AD0E0C41
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20090211/905bbc25/attachment.bin