Re: Expanding on Plone User Manual with additional use cases

Here's drupals site recipes.
http://drupal.org/handbook/site-recipes
Note all drupal's documentation is wiki now and I think site-recipes and howtos really do (as Joanna sugests) have to be in hte community section as these are the kind of thing that will get updated regularly. And may have different ways of achieving the same result which people should feel free to include as an alternative on the same page.


I was talking to a guy in the drupal community the other day and  
they've recently restructered their docs. One thing they use a lot of  
is "Site recipes". Howtos on how people solved particular problems on  
particular sites. Given that such uses cases as described below could  
be many and varied, perhaps its a better idea for them to go into the  
upcomming wiki documentation area rather than manuals? Perhaps the  
concept of Site Recipe could fit well with us too, including buildout  
examples, permissions structure, and which 3rd party products were used.


On 28/03/2009, at 11:28 PM, Jeff Pittman wrote:

> Hi Khairil,
>
> I think it would be great to incorporate those into the existing  
> user manual in the "managing-content" area. If they won't fit within  
> the existing pages, we could insert a page called "more examples" at  
> that point.
>
> Maybe you would want to contribute a "more examples" page to get the  
> new examples going -- I would be glad to work with you to help  
> insert it.
>
> Jeff
>
> Jeff Pittman
> http://www.geojeff.org
>
>
> On Sat, Mar 28, 2009 at 5:19 AM, Khairil Yusof <kaeru@inigo- 
> tech.com> wrote:
> Getting them technically done is explained well in the existing  
> manual,
> and examples provided here as points at the end of this page:
>
> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/folder-view
>
> I'm however getting common requests from different users, who seem to
> have trouble converting it to their use cases.
>
> The request for my users (government/NGO project websites) usually
> revolve around "collaborative spaces" use cases.
>
> * Joe want to put up drafts of documents for feedback (comments).
>
> * Jane wants to create a wiki (usually they just mean enable Sharing)
>  - container folder, wiki markup, enable comments (talk), history
>
> * Joe and Jane, want to collaborate on a workshop event, where
>  they would have a shared folder to collaborate on pages such
>  as agenda, schedule, news, event item, photos and maybe video
>  gallery
>
> I'm wondering, is there a place (or need) on Plone.org for step by  
> step
> illustrated guide of examples in same style as the user manual to put
> these up?
>
> Would Examples in the existing manual to expand on the points at the  
> url
> mentioned in the manual be appropriate? They're kinda like programming
> recipes, except for users.
>
> I'm already working on these for my users, and would love to  
> contribute
> them to plone doc efforts if possible.
>
> Regards
>
>
> ------------------------------------------------------------------------------
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs
>
> ------------------------------------------------------------------------------
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs


------------------------------------------------------------------------------
_______________________________________________
Plone-docs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/plone-docs



-- 
View this message in context: http://n2.nabble.com/Expanding-on-Plone-User-Manual-with-additional-use-cases-tp2548585p2551336.html
Sent from the Documentation Team mailing list archive at Nabble.com.


------------------------------------------------------------------------------