Re: Plone 3.2 User Manual Update

If it¹s just the content of the manual, and not the URL itself, we should
change it. 


On 12/22/08 10:40 AM, "Jeff Pittman" <[email protected]> wrote:

> The screencasts in the Plone 3 manual have always needed updating (they are
> for Plone 2). :)
> 
> The question about the manual title change is significant, because the title
> and the line at the top of the main page say that the manual applies just to
> Plone 3.0, which is incorrect (but, again, thank goodness, the short name of
> the manual is plone-3-user-manual). Here's what the top of the main page says
> now:
>         Plone 3.0 User Manual
> This Reference Manual applies to:          Plone 3.0.x
> 
> Jeff
> 
> Jeff Pittman
> http://www.geojeff.org
> 
> 
> On Mon, Dec 22, 2008 at 12:19 PM, 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 <http://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/conce
>>> ptual-overview
>>> >
>>> > OK
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/introduction/visua
>>> l-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/setti
>>> ng-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/add
>>> ing-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/wha
>>> ts-in-a-web-name
>>> >
>>> > OK
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/add
>>> ing-images
>>> >
>>> > OK
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/pre
>>> paring-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/add
>>> ing-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/add
>>> ing-files
>>> >
>>> > OK
>>> >
>>> > Screencast is for Plone 2.0, as warned on the page.
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/add
>>> ing-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/add
>>> ing-events
>>> >
>>> > OK
>>> >
>>> > Screencast is for Plone 2.0, as warned on the page.
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/add
>>> ing-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/set
>>> ting-basic-properties
>>> >
>>> > OK
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/adding-content/res
>>> tricting-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/c
>>> utting-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/e
>>> diting-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/f
>>> older-view
>>> >
>>> > OK
>>> >
>>> > Screencast is for Plone 2.0, as warned on the page.
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/f
>>> older-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/r
>>> eordering-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/p
>>> revious-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/d
>>> eleting-items
>>> >
>>> > OK
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/l
>>> ocking-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/w
>>> orking-copy-3-0
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/managing-content/v
>>> ersioning
>>> >
>>> > 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-workfl
>>> ow-and-collaboration/basic-publication-states
>>> >
>>> > OK
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/publication-workfl
>>> ow-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-workfl
>>> ow-and-collaboration/workflow-policies
>>> >
>>> > OK
>>> >
>>>>>>>> >>>>>><<<<<
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/publication-workfl
>>> ow-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-u
>>> seful-basic-documentation
>>> > 
>>> http://plone.org/documentation/manual/plone-3-user-manual/next-steps/from-us
>>> er-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
>>> >
>>> >
>> 
>

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

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