Re: Plone 3.2 User Manual Update

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/conceptual-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/setting-your-preferences
http://plone.org/documentation/manual/plone-3-user-manual/introduction/your-dashboard

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/adding-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/whats-in-a-web-name

OK

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/adding-content/adding-images

OK

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/adding-content/preparing-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/adding-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/adding-files

OK

Screencast is for Plone 2.0, as warned on the page.

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/adding-content/adding-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/adding-events

OK

Screencast is for Plone 2.0, as warned on the page.

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/adding-content/adding-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/setting-basic-properties

OK

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/adding-content/restricting-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/cutting-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/editing-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/folder-view

OK

Screencast is for Plone 2.0, as warned on the page.

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/managing-content/folder-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/reordering-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/previous-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/deleting-items

OK

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/managing-content/locking-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/working-copy-3-0
http://plone.org/documentation/manual/plone-3-user-manual/managing-content/versioning

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/introduction-to-collections

OK

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/using-collections/adding-collections

OK

Screencast is for Plone 2.0, as warned on the page.

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/using-collections/adjusting-the-display-settings
http://plone.org/documentation/manual/plone-3-user-manual/using-collections/definition-of-criteria
http://plone.org/documentation/manual/plone-3-user-manual/using-collections/sort-order
http://plone.org/documentation/manual/plone-3-user-manual/using-collections/using-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-workflow-and-collaboration/basic-publication-states

OK

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/publication-workflow-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-workflow-and-collaboration/workflow-policies

OK

>>>>><<<<<
http://plone.org/documentation/manual/plone-3-user-manual/publication-workflow-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-useful-basic-documentation
http://plone.org/documentation/manual/plone-3-user-manual/next-steps/from-user-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