Re: kb -> c.developermanual

Hi.

On 6/19/11 7:36 AM, Dylan Jay wrote:
> Hi,
>
> There's lots of links in the collective developers manual to KB
> articles. Is there any reason not to just import those documents
> directly into the manual and remove the KB article?

Yes.

I'll state the obvious: because it may offend the KB article author. I 
suspect you'd need to contact the author directly and ask where they'd 
prefer their article to live.

Note: we've still got a "mess" on our hands wrt to collective docs. I am 
hoping to clean up and automate the inclusion of c-docs in plone.org as 
soon as someone from the board replies to this ticket:

* https://dev.plone.org/plone/ticket/11771


Right now we have:

* Out of date c-docs on plone.org/documentation (because no one 
understands the upload process[1]). I'm now OK with fixing this (i.e. I 
know how to do it).

* Out of date c-docs on collective-docs.plone.org because your recent 
changes added a Sphinx module that does not exist on deus (includedocs 
IIRC).


As I am not terribly interested in fixing deus[2], I've recently 
considered moving c-docs to github and publishing them to 
readthedocs.org (which moo has +1'd). But I still need to test.



Alex




[1] Either that or it's too brittle. I can't remember which. Note: I've 
never actually run bin/toplone on plone.org, but I do understand now how 
it is supposed to work, so I plan to explore some cronomation of this at 
which time I'll try to resolve any issues that may have been occurring.

[2] Yes, I'm that lazy and stubborn. :-) If anyone reading this wants to 
poke at it, and can get "make html" in 
deus:/srv/collective-docs.plone.org working (presumably by installing 
the includedocs module in whichever Python is being used, please do!)


>
>
> ---
> Dylan Jay
> Technical Solutions Manager
> PretaWeb: reducing duplication in the government web.
> P: +612 80819071 | M: +61421477460 | twitter.com/djay75 | linkedin.com/
> in/djay75
>
>
> ------------------------------------------------------------------------------
> EditLive Enterprise is the world's most technically advanced content
> authoring tool. Experience the power of Track Changes, Inline Image
> Editing and ensure content is compliant with Accessibility Checking.
> http://p.sf.net/sfu/ephox-dev2dev


-- 
Alex Clark · http://aclark.net


------------------------------------------------------------------------------
All of the data generated in your IT infrastructure is seriously valuable.
Why? It contains a definitive record of application performance, security 
threats, fraudulent activity, and more. Splunk takes this data and makes 
sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-d2d-c2