From 23e39115e4f502d79f4958f42d1e10e01f78cac7 Mon Sep 17 00:00:00 2001 From: bshuttle Date: Mon, 23 Jan 2006 10:07:09 +0000 Subject: [PATCH] descriptiveText improvements from Daniel Chalef --- templates/ktcore/folder/roles.smarty | 4 ++-- templates/ktcore/folder/roles_managegroups.smarty | 2 +- templates/ktcore/metadata/editFieldset.smarty | 6 +++--- templates/ktcore/metadata/listFieldsets.smarty | 4 +--- templates/ktcore/principals/addgroup.smarty | 4 ++-- templates/ktcore/principals/adduser.smarty | 2 +- templates/ktcore/principals/editgroup.smarty | 2 +- templates/ktcore/principals/edituser.smarty | 2 +- templates/ktcore/principals/groupadmin.smarty | 2 +- templates/ktcore/principals/groups_managesubgroups.smarty | 6 ++---- templates/ktcore/principals/groups_manageusers.smarty | 4 ++-- templates/ktcore/principals/password.smarty | 2 +- templates/ktcore/principals/preferences.smarty | 3 +-- templates/ktcore/principals/unitadmin.smarty | 2 +- templates/ktcore/principals/updatepassword.smarty | 2 +- templates/ktcore/principals/usergroups.smarty | 8 +++----- 16 files changed, 24 insertions(+), 31 deletions(-) diff --git a/templates/ktcore/folder/roles.smarty b/templates/ktcore/folder/roles.smarty index b392f2a..71c290f 100644 --- a/templates/ktcore/folder/roles.smarty +++ b/templates/ktcore/folder/roles.smarty @@ -7,7 +7,7 @@ {/i18n}

{i18n}Warning:{/i18n}{i18n} Please note that changing -role allocations can take very long time, depending on the number of folders below this one.{/i18n}

+role allocations may take a some time, depending on the number of folders below this one.{/i18n}

@@ -48,4 +48,4 @@ role allocations can take very long time, depending on the number of folders bel {/if} -

{i18n}No roles defined in the Role Administration area.{/i18n}

\ No newline at end of file + diff --git a/templates/ktcore/folder/roles_managegroups.smarty b/templates/ktcore/folder/roles_managegroups.smarty index 9b24405..bc300ed 100644 --- a/templates/ktcore/folder/roles_managegroups.smarty +++ b/templates/ktcore/folder/roles_managegroups.smarty @@ -18,7 +18,7 @@
{i18n}Allocate Groups to Role{/i18n} -

{i18n}Select the groups which should be part of this role.{/i18n} FIXME this helptext is v. awkward.

+

{i18n}Select the groups which should be part of this role.{/i18n}

diff --git a/templates/ktcore/metadata/editFieldset.smarty b/templates/ktcore/metadata/editFieldset.smarty index 5fb4ebb..f435987 100644 --- a/templates/ktcore/metadata/editFieldset.smarty +++ b/templates/ktcore/metadata/editFieldset.smarty @@ -13,7 +13,7 @@ {i18n}Fieldset properties{/i18n}

- FIXME add help text for fieldset editing. + {i18n}Please complete the following fields to edit the fieldset's properties and then click Change. Required fields are marked with a red square.{/i18n}

@@ -110,7 +110,7 @@ field can depend on the user's selections for the others.{/i18n}

{i18n}Fieldset members{/i18n}

- FIXME add help text for fieldset members. + {i18n}A fieldset is a collection of fields that comprise a defined set of document metadata. You may add, edit or delete members of this fieldset collection below.{/i18n}

@@ -144,7 +144,7 @@ href="{$smarty.server.PHP_SELF}?action=editField&fFieldId={$oField->getId()}&fFi
{i18n}Add a new field{/i18n} -

FIXME add help text for field creation.

+

{i18n}To add a new field, enter the field's name, description and field type below and then click Add field. If the field type requires additional lookup values you will be prompted to enter them.{/i18n}

diff --git a/templates/ktcore/metadata/listFieldsets.smarty b/templates/ktcore/metadata/listFieldsets.smarty index acb04f2..8e698a6 100644 --- a/templates/ktcore/metadata/listFieldsets.smarty +++ b/templates/ktcore/metadata/listFieldsets.smarty @@ -1,6 +1,6 @@

{i18n}Document Fieldsets{/i18n}

-

FIXME add documentation about what fieldsets are, and how to use them.

+

{i18n}Collections of fields are associated into fieldsets. These represent a set of related information which can be associated with a document and thus comprise part of the document's metadata.{/i18n}

{ if $fieldsets}

{i18n}Existing document fieldsets{/i18n}

@@ -53,8 +53,6 @@
{i18n}Create a new document fieldset{/i18n} -

FIXME add documentation about what fieldsets are, and how to use them.

- diff --git a/templates/ktcore/principals/addgroup.smarty b/templates/ktcore/principals/addgroup.smarty index 89b4610..d728b9d 100644 --- a/templates/ktcore/principals/addgroup.smarty +++ b/templates/ktcore/principals/addgroup.smarty @@ -1,13 +1,13 @@

{i18n}Add a new group{/i18n}

-

{i18n}Add a new group{/i18n}

+

{i18n}Users may be classed together as Groups and these groups may be used to set security privileges throughout the document management system.{/i18n}

{i18n}Specify group details{/i18n} -

FIXME brief overview of group editing.

+

{i18n}Please enter the Group's details below and then click create group. Fields marked with a red square are required.{/i18n}

{foreach item=oWidget from=$add_fields} {$oWidget->render()} {/foreach} diff --git a/templates/ktcore/principals/adduser.smarty b/templates/ktcore/principals/adduser.smarty index d4b3024..c7a43be 100644 --- a/templates/ktcore/principals/adduser.smarty +++ b/templates/ktcore/principals/adduser.smarty @@ -1,6 +1,6 @@

{i18n}Add a user{/i18n}

-

FIXME brief overview of user management.

+

{i18n}Please complete the form below to add a new user. Fields marked with a red square are required. By default, users are created using KnowledgeTree's builtin authentication provider. Should you wish to use an external authentication provider such as LDAP, please ensure that the provider's plugin is registered and enabled.{/i18n}

{if $authentication_sources} diff --git a/templates/ktcore/principals/editgroup.smarty b/templates/ktcore/principals/editgroup.smarty index 132ba1a..bd6e7e0 100644 --- a/templates/ktcore/principals/editgroup.smarty +++ b/templates/ktcore/principals/editgroup.smarty @@ -8,7 +8,7 @@ the system's information about group #name{/i18n}

{i18n}Change Group Details{/i18n} -

FIXME brief overview of group editing.

+

{i18n}Users may be classed together as Groups and these groups may be used to set security privileges throughout the document management system.{/i18n}

{foreach item=oWidget from=$edit_fields} {$oWidget->render()} {/foreach} diff --git a/templates/ktcore/principals/edituser.smarty b/templates/ktcore/principals/edituser.smarty index a8697cf..4f93868 100644 --- a/templates/ktcore/principals/edituser.smarty +++ b/templates/ktcore/principals/edituser.smarty @@ -5,7 +5,7 @@
{i18n}Change User Details{/i18n} -

FIXME brief overview of user editing.

+

{i18n}Please complete the form below to edit the user. Fields marked with a red square are required. By default, users are created using KnowledgeTree's builtin authentication provider. Should you wish to use an external authentication provider such as LDAP, please ensure that the provider's plugin is registered and enabled.{/i18n}

{foreach item=oWidget from=$edit_fields} {$oWidget->render()} diff --git a/templates/ktcore/principals/groupadmin.smarty b/templates/ktcore/principals/groupadmin.smarty index 1916e8e..fe28431 100644 --- a/templates/ktcore/principals/groupadmin.smarty +++ b/templates/ktcore/principals/groupadmin.smarty @@ -9,7 +9,7 @@

{i18n}Since there may be many groups in the system, please type a few letters from the group's name to begin. Alternatively, view all groups (note that this -may be very slow if you have many groups.{/i18n}

+action may take some time if you have many groups).{/i18n}

{foreach item=oWidget from=$search_fields} {$oWidget->render()} diff --git a/templates/ktcore/principals/groups_managesubgroups.smarty b/templates/ktcore/principals/groups_managesubgroups.smarty index 4eb0f10..acfbece 100644 --- a/templates/ktcore/principals/groups_managesubgroups.smarty +++ b/templates/ktcore/principals/groups_managesubgroups.smarty @@ -5,9 +5,7 @@ {$context->oPage->requireJSResource('thirdpartyjs/MochiKit/Iter.js')} {$context->oPage->requireJSResource('thirdpartyjs/MochiKit/DOM.js')} -

FIXME help text for group-editing. -FIXME there are potential unexpected -side-effects to this when used by unitAdmins.

+

{i18n}Groups may contain other groups, allowing for a convenient way to build tree's of users and efficiently assign security privileges.{/i18n}

@@ -20,7 +18,7 @@ side-effects to this when used by unitAdmins.

{i18n arg_name=$edit_group->getName()}Change Sub-Groups in #name#{/i18n} -

{i18n}Select the groups which should be part of this group.{/i18n} FIXME this helptext is v. awkward.

+

{i18n}Select the groups from the left-hand list that you would like to add to this group and then click the right pointing arrows. Once you have added all the groups that you require, press save changes. Only groups that are logically capable of being included in this group will be available to be added.{/i18n}

diff --git a/templates/ktcore/principals/groups_manageusers.smarty b/templates/ktcore/principals/groups_manageusers.smarty index 0da5375..b608305 100644 --- a/templates/ktcore/principals/groups_manageusers.smarty +++ b/templates/ktcore/principals/groups_manageusers.smarty @@ -5,7 +5,7 @@ {$context->oPage->requireJSResource('thirdpartyjs/MochiKit/Iter.js')} {$context->oPage->requireJSResource('thirdpartyjs/MochiKit/DOM.js')} -

FIXME help text for group-editing. +

{i18n}Users may be associated with Groups which are then used to grant these users security privileges.{/i18n}

@@ -18,7 +18,7 @@
{i18n arg_name=$edit_group->getName()}Manage Users in #name#{/i18n} -

{i18n}Select the users which should be part of this group.{/i18n} FIXME this helptext is v. awkward.

+

{i18n}Select the users which should be part of this group from the left-hand list and then click the right pointing arrows. Once you have added all the users that you require, press save changes.{/i18n}

diff --git a/templates/ktcore/principals/password.smarty b/templates/ktcore/principals/password.smarty index 5c5e4dd..b5f5ac8 100644 --- a/templates/ktcore/principals/password.smarty +++ b/templates/ktcore/principals/password.smarty @@ -1,6 +1,6 @@

Password

-

FIXME better helptext. Change your password.

+

{i18n}You may change your password by entering it in the fields below. Your system administrator may have defined certain rules (such as minimum password length) that your password must abide by.{/i18n}

diff --git a/templates/ktcore/principals/preferences.smarty b/templates/ktcore/principals/preferences.smarty index a1c219a..d8f60f1 100644 --- a/templates/ktcore/principals/preferences.smarty +++ b/templates/ktcore/principals/preferences.smarty @@ -1,7 +1,6 @@

Preferences

-

{i18n}From here you can adjust certain basic -preferences about how you work with KnowledgeTree.{/i18n}

+

{i18n}You may change details about yourself by editing the entries below. Once you have completed the form, click on Update your details.{/i18n}

diff --git a/templates/ktcore/principals/unitadmin.smarty b/templates/ktcore/principals/unitadmin.smarty index 56debd2..12bfa0d 100644 --- a/templates/ktcore/principals/unitadmin.smarty +++ b/templates/ktcore/principals/unitadmin.smarty @@ -1,6 +1,6 @@

{i18n}Unit Administration{/i18n}

-

FIXME Overview of units.

+

{i18n}KnowledgeTree allows administrators the ability to create Units that model the organisation's business units. Units may have their own administrators and users and groups may be assigned to these units.{/i18n}

{if ($for_edit === false)} diff --git a/templates/ktcore/principals/updatepassword.smarty b/templates/ktcore/principals/updatepassword.smarty index 90f57bf..4627cf0 100644 --- a/templates/ktcore/principals/updatepassword.smarty +++ b/templates/ktcore/principals/updatepassword.smarty @@ -5,7 +5,7 @@
{i18n}Change User's Password{/i18n} -

{i18n}Change the user's password.{/i18n}

+

{i18n}Change the user's password. Password rules may have been defined that this new password must abide by.{/i18n}

{foreach item=oWidget from=$edit_fields} {$oWidget->render()} {/foreach} diff --git a/templates/ktcore/principals/usergroups.smarty b/templates/ktcore/principals/usergroups.smarty index 5027eeb..b17d90a 100644 --- a/templates/ktcore/principals/usergroups.smarty +++ b/templates/ktcore/principals/usergroups.smarty @@ -5,9 +5,7 @@ {$context->oPage->requireJSResource('thirdpartyjs/MochiKit/Iter.js')} {$context->oPage->requireJSResource('thirdpartyjs/MochiKit/DOM.js')} -

FIXME help text for group-editing. -FIXME there are potential unexpected -side-effects to this when used by unitAdmins.

+

{i18n}Users may be classed together as Groups and these groups may be used to set security privileges throughout the document management system.{/i18n}

@@ -20,8 +18,8 @@ side-effects to this when used by unitAdmins.

{i18n arg_name=$edit_user->getName()}Change #name#'s Groups{/i18n} -

{i18n}Select the groups which should -contain this user.{/i18n} FIXME this helptext is v. awkward.

+ +

{i18n}Select the groups which this user should belong to from the left-hand list and then click the right pointing arrows. Once you have added all the groups that you require, press save changes.{/i18n}

-- libgit2 0.21.4