Re: Plone 3.2 User Manual Update

Can we look at assigning a team of people to write screencast scripts and
start putting a plan together for this? If nothing else, as part of the gap
assessment, editors should be able to identify a handful of screencasts that
would benefit their individual sections.


On 12/22/08 10:19 AM, "JoAnna Springsteen" <[email protected]> wrote:

> Yeah I haven't had a chance yet to read through Jeff's incredibly
> thorough list.
> In general, if we want to redo the screencasts just to update them,
> then that's great. As Limi said, there shouldn't be any real need to
> do so because of UI updates. But if we want to make improvements then
> that's great. Same thing with text.
> Definitely don't need an entire separate manual just for 3.2. As far
> as URLs changing and such, let's wait on that as well. Anything that
> is technical concerning plone.org itself is best left until after we
> are upgraded. (which should be next week?!?!?)
> 
> 
> 
> On Mon, Dec 22, 2008 at 12:06 PM, Veda Williams <veda-PRw/[email protected]> wrote:
>> Joanna, Sam, I assume you guys can work through this stuff and make changes
>> where necessary?
>> 
>> I'm a little hesitant to change the URLs for some of these until we have the
>> 3.0 URL redirection working for us. Since this is coming very soon, I'd like
>> to hold off on changing these until SteveM and I have a chance to work our
>> magic.
>> 
>> - Veda
>> 
>> 
>> On 12/22/08 2:46 AM, "Jeff Pittman" <[email protected]> wrote:
>> 
>> Sorry, I had the mistaken idea that the user interface changes in the 3.1
>> series were significant, but I see now -- the UI has been stable -- good job
>> Plone!
>> 
>> There are a few little things that have changed, but nothing really serious
>> that we can't edit in place in the existing Plone 3 manual. And I can see
>> where work on an updated user manual should target the Plone 4 series.
>> 
>> The short name of the manual is plone-3-user-manual, but the title is Plone
>> 3.0 User Manual. The title would be fine, better in fact, as Plone 3 User
>> Manual. Should we change it? Implications for links to the manual? (we would
>> be changing title, not short name).
>> 
>> Here are comments from a comparison of 3.0 to 3.1.7 user interface
>> differences, and update needs to 3.0 user manual. See mentions of CHANGED
>> for a few things.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/introduction/concep
>> tual-overview
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/introduction/visual
>> -design-of-plone-web-sites
>> 
>> CHANGED
>> 
>> Sites showcased with screen captures are:
>> 
>> http://www.akamai.com/ -- significantly different now. Still Plone?
>> 
>> http://discovermagazine.com/ -- significantly different now. Still Plone?
>> 
>> http://www.smeal.psu.edu/ -- Looks the same.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/introduction/plone-
>> user-accounts
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/introduction/settin
>> g-your-preferences
>> http://plone.org/documentation/manual/plone-3-user-manual/introduction/your-d
>> ashboard
>> 
>> CHANGED
>> 
>> Default dashboard now shows Recent Changes portlet. (It was empty initially
>> in 3.0).
>> 
>> There is now a Change Password link between Profile and Personal Preferences
>> links.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/addi
>> ng-folders
>> 
>> CHANGED
>> 
>> Add new drop-down menu has lost the bottom menu item, Page Restrictions...
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/what
>> s-in-a-web-name
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/addi
>> ng-images
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/prep
>> aring-images-for-the-web
>> 
>> OK
>> 
>> Note: This page is linked at the top of the adding-images page, and is a
>> page that repeats later. OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/addi
>> ng-pages
>> 
>> OK Kupu menu bar is even the same, which is surprising.
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/addi
>> ng-files
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/addi
>> ng-links
>> 
>> OK
>> 
>> Screencasts (2) are for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/addi
>> ng-events
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/addi
>> ng-news-items
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/sett
>> ing-basic-properties
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/rest
>> ricting-types-in-a-folder
>> 
>> CHANGED
>> 
>> As this has been removed from the Add new drop-down menu, this could just be
>> deleted?
>> 
>> Besides, I can't even find this functionality in another place?
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/cu
>> tting-copying-and-pasting-items
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/ed
>> iting-content
>> 
>> OK Checked mouse-over actions to trigger editing on a page, for the title
>> and body text. OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/fo
>> lder-view
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/fo
>> lder-contents
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>> Comment on the page: drag-drop reordering -- folder contents is the only
>> place you can do reordering within a folder, but if you have a folder with
>> more than 20 items you can't seem to do this cause of the next/previous page
>> issue. Is there a way to display all items in a folder to allow full
>> ordering control ?
>> 
>> Added comment to say that reordering info is on the next page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/re
>> ordering-items
>> 
>> OK
>> 
>> Several comments on the page, for workarounds to reorder more than 20 items.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/pr
>> evious-next-links
>> 
>> OK I didn't see the Default/Categorization/Dates/Ownership/Settings panel
>> for editing a folder, but then I realized I was trying it on the home
>> folder, which must be different. I created a test folder and added some
>> pages, enabled previous-next, and it worked fine.
>> 
>> There are interesting comments on this page about problems, but one comment
>> says "solved" and describes the effects of Apache proxying, etc.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/de
>> leting-items
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/lo
>> cking-and-unlocking-3-0
>> 
>> OK I've seen the unlock panel pop up on recent Plone 3.1 sites and it seems
>> to work the same.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/wo
>> rking-copy-3-0
>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/ve
>> rsioning
>> 
>> These are Darci's pages, for functionality I haven't used yet -- I assume
>> screen captures are still valid (didn't check).
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/using-collections/i
>> ntroduction-to-collections
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/using-collections/a
>> dding-collections
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/using-collections/a
>> djusting-the-display-settings
>> http://plone.org/documentation/manual/plone-3-user-manual/using-collections/d
>> efinition-of-criteria
>> http://plone.org/documentation/manual/plone-3-user-manual/using-collections/s
>> ort-order
>> http://plone.org/documentation/manual/plone-3-user-manual/using-collections/u
>> sing-and-understanding-dates
>> 
>> http://plone.org/documentation/manual/plone-3-user-manual/portlet-management/
>> portlet-hierarchy
>> http://plone.org/documentation/manual/plone-3-user-manual/portlet-management/
>> managing-portlets
>> http://plone.org/documentation/manual/plone-3-user-manual/portlet-management/
>> portlet-types
>> 
>> CHANGED (ADDED)
>> 
>> Aha!  This is what Sam wanted to do -- he added these pages in November,
>> 2008.
>> 
>> Good job Sam!
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/publication-workflo
>> w-and-collaboration/basic-publication-states
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/publication-workflo
>> w-and-collaboration/advanced-control
>> 
>> OK
>> 
>> Screencast is for Plone 2.0, as warned on the page.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/publication-workflo
>> w-and-collaboration/workflow-policies
>> 
>> OK
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/publication-workflo
>> w-and-collaboration/collaboration-through-sharing
>> 
>> Comment on page: How would you prevent people who are not logged in to view
>> the content of a directory of a file in a directory?
>> 
>> Reply added. See
>> http://plone.org/documentation/how-to/make-folder-hierarchy-private.
>> 
>>>>>>> <<<<<
>> http://plone.org/documentation/manual/plone-3-user-manual/next-steps/other-us
>> eful-basic-documentation
>> http://plone.org/documentation/manual/plone-3-user-manual/next-steps/from-use
>> r-to-site-administrator-and-beyond
>> 
>> OK
>> 
>> Jeff Pittman
>> http://www.geojeff.org
>> 
>> 
>> On Sun, Dec 21, 2008 at 9:40 PM, Alexander Limi <limi-z4DKO/[email protected]> wrote:
>> 
>> On Sat, 20 Dec 2008 02:50:39 -0800, Jeff Pittman
>> <[email protected]> wrote:
>> 
>>> I am interested in working on a Plone 3.2 version of the user manual. One
>>> way of doing it is to copy the 3.0 version (manual content type in PHC),
>>> then modifying in place for 3.2. That's what we did when we made a 3.0
>>> manual from the 2.5 version. Steve, iirc, you did something special to
>>> copy
>>> it?
>> 
>> I just want to echo what Steve said earlier ‹ if there is a need for a
>> separate 3.2 manual, then 3.2 is not a successful release. The whole idea
>> about the 3.x line is that interface stability is paramount, if you sit
>> down in front of Plone 3.0 or 3.2 or 3.7, it shouldn't matter.
>> 
>> Yes, this means that we can't improve the UI in a significant way in the
>> 3.x series, but even I can see that this is for the better, and swallow my
>> UI pride and put that energy towards Plone 4 instead. :)
>> 
>> In general, we should strive to talk about "Plone 3" wherever possible,
>> not "Plone 3.2" or "Plone 3.1". I have made this same mistake several
>> times in documentation and other pages, but I try to correct it whenever I
>> stumble over it in the existing docs.
>> 
>>> New screen captures, updated text, and replacement screencasts will be
>>> needed.
>> 
>> Hopefully not.
>> 
>> --
>> Alexander Limi · http://limi.net
>> 
>> 
>> 
----------------------------------------------------------------------------->>
-
>> _______________________________________________
>> 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
>> 
>> 


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