Quote from README.txt from revisioning-6.x-2.7.tar.gz:

INSTALLATION
============
0. Install the Module Grants module as per its README instructions.
   Optionally install the Diff module if you want to compare revisions and
   highlight the differences.
1. Place the "revisioning" folder in your "sites/all/modules" directory.
2. Enable the module under Administer >> Site building >> Modules.
3. Under Administer >> Content >> Content types, click "edit" next to the
   content types for which you wish to enable/disable revisioning. Under
   "Workflow Settings", Default Options, tick both the "Create new revision"
   and "New revision in draft, pending moderation" checkboxes. Also in this
   section UNtick "Published", so that all new content is created in an 
   unpubished state, i.e. invisible to the public.
4. The module creates a new root menu item, named "My content" with three tabs:
   o "Viewable" shows all nodes that may be viewed by the logged-in user
   o "Editable" shows all nodes that may be edited by the logged-in user
   o "Pending", a subset of "Editable" showing nodes that have been revised
     recently and are awaiting review and publication by an authorised role.
   These menu options will be visible only to roles that have the "access
   content summary" permission, as granted by the administrator.
5. Grant to the various roles the view/delete/revert revisions permissions
   (node access section) and the "edit revisions" permission (revisioning
   section). Typically you'd give authors the "view revisions" and
   "edit revisions" permissions, while moderators will get the same as well
   as the "publish/revert revisions" permission. Neither require the 
   "administer nodes" permission, which is a good thing as this gives 
   excessive rights.

Ad 3 till 5) Please, list these instructions under a CONFIGURATION (not INSTALLATION) section within the documentation.
Ad 3) Please, clarify in the help text of the configuration option "New revision in draft, pending moderation". I think (but hope to get some verification on this in this topic) that it means something like: "Allow authors to edit/ delete their new revisions, as long as those revisions have not been moderated". Perhaps the help text and/ or documentation should also refer to: http://drupal.org/node/472710

Comments

rdeboer’s picture

Assigned: Unassigned » rdeboer
Status: Active » Needs work

Thanks for your suggestions.
Trust you got it to work though?
Rik

not_Dries_Buytaert’s picture

Title: Add configuration section + clarify configuration option "New revision in draft, pending moderation" » Add configuration section to + update documentation + clarify configuration option "New revision in draft, pending moderation"
Category: feature » bug

Thank you for being so responsive and willing to incorporate the suggestions. :-)

The module functions as designed and suffers only from known (already reported) bugs, as fas as I have tested so far. I am still in the process of testing it, though.

Please, confirm in this topic what the "New revision in draft, pending moderation" option does, so I can finalize my testing. In contrast to what I wrote earlier, I think (but am not really sure) that this option causes updating an EXISTING revision (instead of creating a new one) if that revision is still pending for moderation.
Is this assumption correct?

Ad 4) I believe this instruction is outdated, as the navigation menu item changed from "My content" to "Accessible content"
ad 4 & 5) I believe this instruction is outdated, as following tabs changed from:
"" to "I created"
"Viewable" to "I can view"
"Editable" to "I can edit"
"Pending" to "I last modified"

NB: Also, in the permissions page under the "revisioning module" section, the name of the field "access 'Pending' tab" is outdated, as for constancy it should be "access 'I last modified' tab". Please, change this.

Aforementioned issues are actually (tiny) bugs.

rdeboer’s picture

Re 4) and 5) and the names of the tabs ... the Revisioning and Module Grants README.txt files were updated before your post came in. They're in the development snapshot versions of these modules.

I may follow your suggestion to add more explanation to the README.txt file, although I think this info is probably better suited for the tutorials on the Revisioning project page.

To answer your question:
"New revision in draft, pending moderation" means that when a user edits a piece of content two things happen
1) a new revision is created (via the "Create new revision" tickbox which should also be ticked).
2) unlike default core behaviour, this new revision is NOT automatically made "current"; the publicly visible revision remains unchanged.

There is an additional radiobox on the same page (Administer >> Content management >> Content types >> edit that augments the above behaviour giving you the option to "Only create a new revision when saving content that is not already in draft/pending moderation". This will save you some disk space, because until the draft is published all saved modifications will be applied to the same copy, i.e. no new revision is created when one already exists.
On the other hand there are situations, for instance in a Wiki page with multiple authors editing the same copy, where you do want every Save to create a new draft (revision), so that contributors can compare what was changed between Saves.
The Diff module is a good addition to Revisioning for this.

NB: Also, in the permissions page under the "revisioning module" section, the name of the field "access 'Pending' tab" is outdated, as for constancy it should be "access 'I last modified' tab".

I don't think so. "access I Last Modified" tab is a permission that pertains to Module Grants (a module that one can use on its own without Revisioning), while "access Pending tab" has everything to do with Revisioning.

Hope this helps

Rik

rdeboer’s picture

Category: bug » feature
Status: Needs work » Fixed

Added elaboration on "New revision in draft, pending moderation" to README.txt file.
Available in versions of Revisioning of 20 Nov 09 or later.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.