[Checkins] SVN: Products.CMFDefault/trunk/docs/narrative/ Old help docs moved to "narrative" folder
Charlie Clark
cvs-admin at zope.org
Thu Mar 22 10:41:54 UTC 2012
Log message for revision 124682:
Old help docs moved to "narrative" folder
Changed:
A Products.CMFDefault/trunk/docs/narrative/
D Products.CMFDefault/trunk/docs/narrative/ActorDefinitions.rst
A Products.CMFDefault/trunk/docs/narrative/ActorDefinitions.rst
D Products.CMFDefault/trunk/docs/narrative/Actor_ContentCreator.rst
A Products.CMFDefault/trunk/docs/narrative/Actor_ContentCreator.rst
D Products.CMFDefault/trunk/docs/narrative/Actor_Reviewer.rst
A Products.CMFDefault/trunk/docs/narrative/Actor_Reviewer.rst
D Products.CMFDefault/trunk/docs/narrative/MoveCopyContent.rst
A Products.CMFDefault/trunk/docs/narrative/MoveCopyContent.rst
-=-
Deleted: Products.CMFDefault/trunk/docs/narrative/ActorDefinitions.rst
===================================================================
--- Products.CMFDefault/trunk/docs/api/ActorDefinitions.rst 2012-03-21 16:53:30 UTC (rev 124659)
+++ Products.CMFDefault/trunk/docs/narrative/ActorDefinitions.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -1,62 +0,0 @@
-CMF Actors
-==========
-
- **Site Manager** --
- This actor is responsible for implementing site policies
- such as security, workflow associations, metadata and
- syndication policies. The Site Manager is also responsible
- for the overall organizational structure of the site. See
- "Actor: Site Manager":Actor_SiteManager.
-
- **Membership Manager** --
- This actor is responsible for managing who has access to a
- site (particularly back-end line of business users), and
- controls the privileges and properties of users. See
- "Actor: Membership Manager":Actor_MembershipManager.
-
- **Site Developer** --
- This actor is responsible for implementing new
- functionality for a site and making changes to existing
- site capabilities. This is a "programmer" type of role, and
- users acting the Site Developer capacity are technical
- people. See "Actor: Site Developer":Actor_SiteDeveloper.
-
- **Add-on Developer** --
- This actor is responsible for implementing new
- functionality that is suitable for distribution to one or
- more sites. ** See "Actor: Add-On
- Developer":Actor_AddOnDeveloper.
-
- **Site Designer** --
- The Site Designer is responsible for producing and
- maintaining the "look and feel" of a site. This includes
- graphics, layout, navigation and other human factors. See
- "Actor: Site Designer":Actor_SiteDesigner.
-
- **Workflow Designer** --
- The Workflow Designer is responsible for defining new
- workflows and customizing existing workflows to meet
- business goals. See "Actor: Workflow
- Designer":Actor_WorkflowDesigner.
-
- **Content Creator** --
- Content Creators are responsible for producing and
- maintaining the actual content of a site. See "Actor:
- Content Creator":Actor_ContentCreator.
-
- **Reviewer** --
- This actor is responsible for ensuring the quality and
- correctness of site content. See "Actor:
- Reviewer":Actor_Reviewer.
-
- **Site Visitor** --
- A Site Visitor is an "end user" of the site. The visitor
- may or may not have an identity known to the system.
- Visitors with a known identity are referred to as "Members"
- of the site, and often can do more on a site than visitors
- without a known identity ("Guests"). Member visitors often
- have a participatory role on the site. Site Visitors have
- some general goals that are applicable to most sites, but
- many of the specific goals and expectations of Site
- Visitors are dependent upon the specific CMF site. See
- "Actor: Site Visitor":Actor_SiteVisitor.
Copied: Products.CMFDefault/trunk/docs/narrative/ActorDefinitions.rst (from rev 124681, Products.CMFDefault/trunk/docs/api/ActorDefinitions.rst)
===================================================================
--- Products.CMFDefault/trunk/docs/narrative/ActorDefinitions.rst (rev 0)
+++ Products.CMFDefault/trunk/docs/narrative/ActorDefinitions.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -0,0 +1,51 @@
+CMF Actors
+==========
+
+**Site Manager** --
+ This actor is responsible for implementing site policies such as security,
+ workflow associations, metadata and syndication policies. The Site Manager
+ is also responsible for the overall organizational structure of the site.
+ See :doc:`Actor_SiteManager`.
+
+**Membership Manager** --
+ This actor is responsible for managing who has access to a site
+ (particularly back-end line of business users), and controls the privileges
+ and properties of users. See :doc:`Actor_MembershipManager`.
+
+**Site Developer** --
+ This actor is responsible for implementing new functionality for a site and
+ making changes to existing site capabilities. This is a "programmer" type
+ of role, and users acting the Site Developer capacity are technical people.
+ See :doc:`Actor_SiteDeveloper`.
+
+**Add-on Developer** --
+ This actor is responsible for implementing new functionality that is
+ suitable for distribution to one or more sites. ** See :doc:`Actor_AddOnDeveloper`.
+
+**Site Designer** --
+ The Site Designer is responsible for producing and maintaining the "look
+ and feel" of a site. This includes graphics, layout, navigation and other
+ human factors. See :doc:`Actor_SiteDesigner`.
+
+**Workflow Designer** --
+ The Workflow Designer is responsible for defining new workflows and
+ customizing existing workflows to meet business goals. See
+ :doc:`Actor_WorkflowDesigner`.
+
+**Content Creator** --
+ Content Creators are responsible for producing and maintaining the actual
+ content of a site. :doc:`Actor_ContentCreator`.
+
+**Reviewer** --
+ This actor is responsible for ensuring the quality and correctness of site
+ content. See :doc:`Actor_Reviewer`.
+
+**Site Visitor** --
+ A Site Visitor is an "end user" of the site. The visitor may or may not
+ have an identity known to the system. Visitors with a known identity are
+ referred to as "Members" of the site, and often can do more on a site than
+ visitors without a known identity ("Guests"). Member visitors often have a
+ participatory role on the site. Site Visitors have some general goals that
+ are applicable to most sites, but many of the specific goals and
+ expectations of Site Visitors are dependent upon the specific CMF site. See
+ :doc:`Actor_SiteVisitor`.
Deleted: Products.CMFDefault/trunk/docs/narrative/Actor_ContentCreator.rst
===================================================================
--- Products.CMFDefault/trunk/docs/api/Actor_ContentCreator.rst 2012-03-21 16:53:30 UTC (rev 124659)
+++ Products.CMFDefault/trunk/docs/narrative/Actor_ContentCreator.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -1,60 +0,0 @@
-Content Creator Goals
-=====================
-
- * Make information available to the end users of the site.
-
- - "Create a content object":CreateNewContent
-
- o Add Content form with a slightly more involved
- description of each content type that comes with the CMF.
-
- o Next form in succession is the "Standard Resource
- Metadata" form which is now a separate use case. Since
- this is a succession of three steps ("Add Content",
- "Metadata", "Edit") "Define content metadata" use case
- should be merged in with this one.
-
- o "Edit" form.
-
- - **XXX** "Define content metadata":ChangeMetadata
-
- This should mainly be pointers back to "Create a content object".
-
- - "Submit content for publication":SubmitContentForPublication
-
- o Brief discussion of workflow with references back to
- workflow use cases.
-
- o Submit for the default workflow
-
- * Ensure that information is up-to-date and accurate.
-
- - "View personally authored content":ViewMyContent
-
- - "Update existing content":ChangeContent
-
- - "Remove unneeded content":RemoveContent
-
- - "Undo changes to content":UndoChanges
-
-
- * Improve content quality over time using end user
- feedback.
-
- - **XXX** "Make a content object discussable":EnableDiscussion
-
- *Note: this is not a per-object option in stock CMF.*
-
- * Collaborate with other content creators.
-
- - "Give local roles to other users":ManageLocalRoles
-
-
- * Modify content organization to improve maintainability
- or navigation.
-
- - "Add content folders":AddContentFolders
-
- - "Move / copy content between folders":MoveCopyContent
-
- - "Rename content object":RenameContent
Copied: Products.CMFDefault/trunk/docs/narrative/Actor_ContentCreator.rst (from rev 124681, Products.CMFDefault/trunk/docs/api/Actor_ContentCreator.rst)
===================================================================
--- Products.CMFDefault/trunk/docs/narrative/Actor_ContentCreator.rst (rev 0)
+++ Products.CMFDefault/trunk/docs/narrative/Actor_ContentCreator.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -0,0 +1,58 @@
+Content Creator Goals
+=====================
+
+* Make information available to the end users of the site.
+
+- :doc:`CreateNewContent`
+
+ - Add Content form with a slightly more involved
+ description of each content type that comes with the CMF.
+
+ - Next form in succession is the "Standard Resource
+ Metadata" form which is now a separate use case. Since
+ this is a succession of three steps ("Add Content",
+ "Metadata", "Edit") "Define content metadata" use case
+ should be merged in with this one.
+
+ - "Edit" form.
+
+- **XXX** "Define content metadata":ChangeMetadata
+
+ This should mainly be pointers back to :doc:`CreateNewContent`.
+
+- :doc:`SubmitContentForPublication`
+
+ - Brief discussion of workflow with references back to
+ workflow use cases.
+
+ - Submit for the default workflow
+
+* Ensure that information is up-to-date and accurate.
+
+- :doc:`ViewMyContent`
+
+- :doc:`ChangeContent`
+
+- :doc:`RemoveContent`
+
+- :doc:`UndoChanges`
+
+
+* Improve content quality over time using end user feedback.
+
+- **XXX** :doc:`EnableDiscussion`
+
+ *Note: this is not a per-object option in stock CMF.*
+
+* Collaborate with other content creators.
+
+- :doc:`ManageLocalRoles`
+
+
+* Modify content organization to improve maintainability or navigation.
+
+- :doc:`AddContentFolders`
+
+- :doc:`MoveCopyContent`
+
+- :doc:`RenameContent`
Deleted: Products.CMFDefault/trunk/docs/narrative/Actor_Reviewer.rst
===================================================================
--- Products.CMFDefault/trunk/docs/api/Actor_Reviewer.rst 2012-03-21 16:53:30 UTC (rev 124659)
+++ Products.CMFDefault/trunk/docs/narrative/Actor_Reviewer.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -1,23 +0,0 @@
-Reviewer Goals
-==============
-
- * Collaborate with content creators to ensure the quality and
- timeliness of site content.
-
- - "Browse content submitted for review and
- publication":BrowseSubmittedForReview
-
- o Brief description of the Action box, with pointers back to
- where this is set up in the skin.
-
- o Pending lists
-
- - "Approve content for publication":ApproveForPublication
-
- This should mainly be a pointer back into "Browse content
- submitted for review and publication"
-
- * React quickly to resolve issues with published content.
-
- - "Remove content from public site":UnpublishContent
-
Copied: Products.CMFDefault/trunk/docs/narrative/Actor_Reviewer.rst (from rev 124681, Products.CMFDefault/trunk/docs/api/Actor_Reviewer.rst)
===================================================================
--- Products.CMFDefault/trunk/docs/narrative/Actor_Reviewer.rst (rev 0)
+++ Products.CMFDefault/trunk/docs/narrative/Actor_Reviewer.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -0,0 +1,22 @@
+Reviewer Goals
+==============
+
+* Collaborate with content creators to ensure the quality and timeliness of
+ site content.
+
+- :doc:`BrowseSubmittedForReview`
+
+ - Brief description of the Action box, with pointers back to
+ where this is set up in the skin.
+
+ - Pending lists
+
+- :doc:`ApproveForPublication`
+
+ This should mainly be a pointer back into "Browse content
+ submitted for review and publication"
+
+* React quickly to resolve issues with published content.
+
+ - :doc:`UnpublishContent`
+
Deleted: Products.CMFDefault/trunk/docs/narrative/MoveCopyContent.rst
===================================================================
--- Products.CMFDefault/trunk/docs/api/MoveCopyContent.rst 2012-03-21 16:53:30 UTC (rev 124659)
+++ Products.CMFDefault/trunk/docs/narrative/MoveCopyContent.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -1,41 +0,0 @@
-Use Case: Move / copy content between folders
-==============================================
-
-Actor
------
-
-- Content Creator
-
-Assumptions
------------
-
-- Content Creator has logged into the CMF (see "Login to the
- Site" LoginAsMember).
-
-Procedure
----------
-
-1. Navigate to the folder containing the piece of content which
- you would like to move (or copy) to another folder.
-
- To retrieve a list of the content you have authored, see
- "View personally authored content":ViewMyContent
-
-2. In the "Folder contents" view of the folder, check the box next to
- the content object(s) which you would like to move or copy.
-
-3. Click the "Cut" button (or the "Copy" button, if you wish to create
- a copy in the new location rather than moving the content).
-
-4. The system will set a cookie on your browser (you must have cookies
- enabled) representing the items you cut or copied.
-
-5. Navigate to the folder into which you wish to move or copy the
- content (which might be the same folder).
-
-6. Click the "Paste" button. The system will move or copy the content
- into the folder; new content whose IDs would conflict with exising
- content in that folder will receive an auto-generated name, typically
- `copy_of_` plus the original ID.
-
-7. To undo this action, see "Undo changes to content":UndoChanges.
Copied: Products.CMFDefault/trunk/docs/narrative/MoveCopyContent.rst (from rev 124681, Products.CMFDefault/trunk/docs/api/MoveCopyContent.rst)
===================================================================
--- Products.CMFDefault/trunk/docs/narrative/MoveCopyContent.rst (rev 0)
+++ Products.CMFDefault/trunk/docs/narrative/MoveCopyContent.rst 2012-03-22 10:41:51 UTC (rev 124682)
@@ -0,0 +1,39 @@
+Use Case: Move / copy content between folders
+==============================================
+
+Actor
+-----
+
+- Content Creator
+
+Assumptions
+-----------
+
+- Content Creator has logged into the CMF (see :doc:`LoginAsMember`).
+
+Procedure
+---------
+
+1. Navigate to the folder containing the piece of content which you would
+ like to move (or copy) to another folder.
+
+ To retrieve a list of the content you have authored, see :doc:`ViewMyContent`
+
+2. In the "Folder contents" view of the folder, check the box next to the
+ content object(s) which you would like to move or copy.
+
+3. Click the "Cut" button (or the "Copy" button, if you wish to create
+ a copy in the new location rather than moving the content).
+
+4. The system will set a cookie on your browser (you must have cookies
+ enabled) representing the items you cut or copied.
+
+5. Navigate to the folder into which you wish to move or copy the content
+ (which might be the same folder).
+
+6. Click the "Paste" button. The system will move or copy the content into
+ the folder; new content whose IDs would conflict with exising content in that
+ folder will receive an auto-generated name, typically `copy_of_` plus the
+ original ID.
+
+7. To undo this action, see :doc:`UndoChanges`.
More information about the checkins
mailing list