Re: kb -> c.developermanual

On 07/07/2011, at 11:39 AM, Alex Clark wrote:

> 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.

seems a shame as where we really want to go is non-repeated  
documentation.
but I guess you're right, not worth coming up with a process until we  
get manual publishing working.


>
> 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).

I'm happy to fix any coding issues with the funnelweb import. Last  
time I tried it was working.


>
> * 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).

:) sorry about that. But will be worth it if all goes to plan and we  
can kick start core devs into documenting their own work.

>
>
> 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.

So replace collective-docs.plone.org with readthedocs? I think that's  
a good idea.


>
>
>
> 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
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs


------------------------------------------------------------------------------
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