Re: state of plone.org/kb and sprint

Dylan Jay <dylan-Q+/Sk2sTzaxWk0Htik3J/[email protected]> Wed, 28 Aug 2013 08:29:23 +1000
Newsgroups gmane.comp.web.zope.plone.documentation
Message-ID <7693302239741572715@unknownmsgid>
On 28/08/2013, at 12:47 AM, sven <[email protected]> wrote:

> Hi,
>
> I saw it today again on irc, new people are often confused about how we
> handle documentation, with the result that ppl. not able to find
> something or give up looking further because the link for example is
> pointing to developer.plone.org and then they assume it is for
> developers not for admins [happened today].
> The other point is we do have some documentation under plone.org/kb and
> some under developer.plone.org, for example if I take documentation
> about apache, this could be/is confusing ....
> How we want to solve this ?
> - do we still want to use /kb or we want to integrate kb content to
> developer.plone.org
> - if we want to use kb and developer.p.o what goes where ?
> - do we want to have developer.plone.org and for example
> documentation.plone.org ?

I agree the developer manual is now increasingly misnamed. I think
because its successful it now includes everything but the end user
manual.
I think a sprint to review the kb to remove info already covered in the manual.
I think we should move the manual under the same domain. Eg
plone.org/docs/manual/4.3
Perhaps call it the integrator manual or just include the user manual
in one bundle and call it the plone manual.


>
> Any ideas on this ? Anyone ? :)
>
> Oh and what do you think about a 'github issues squashing party' aka a
> documentation sprint ?
>
> cheers
>
> Sven
>
> ------------------------------------------------------------------------------
> Introducing Performance Central, a new site from SourceForge and
> AppDynamics. Performance Central is your source for news, insights,
> analysis and resources for efficient Application Performance Management.
> Visit us today!
> http://pubads.g.doubleclick.net/gampad/clk?id=48897511&iu=/4140/ostg.clktrk
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs

------------------------------------------------------------------------------
Learn the latest--Visual Studio 2012, SharePoint 2013, SQL 2012, more!
Discover the easy way to master current and previous Microsoft technologies
and advance your career. Get an incredible 1,500+ hours of step-by-step
tutorial videos with LearnDevNow. Subscribe today and save!
http://pubads.g.doubleclick.net/gampad/clk?id=58040911&iu=/4140/ostg.clktrk