[documentation] [Documentation task] Revised help copy for handbook's "Profiles" page

[O Govinda]

Issue status update for 
http://drupal.org/node/106058
Post a follow up: 
http://drupal.org/project/comments/add/106058

 Project:      Documentation
 Version:      <none>
 Component:    Admin Guide
 Category:     tasks
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  O Govinda
 Updated by:   O Govinda
 Status:       active

Thanks, Lynette, for the suggestions.  Some really good ones! The new
text is now live in the handbook, with some of your suggested revisions
included. 


Cordially,
O Govinda




O Govinda



Previous comments:
------------------------------------------------------------------------

Sun, 31 Dec 2006 11:47:03 +0000 : O Govinda

Attachment: http://drupal.org/files/issues/Revised help copy for handbook's Profiles page.txt (3.9 KB)

Attached is a revised version of the Profiles help page for the
handbook.



* It simplifies the English, fixes some errors in composition, and
makes things clearer.
* It tells how to enable the module
* It better explains the available fields for custom forms
* It tells how to put "User list" on your menus
* It documents the assignment of relevant permissions
* It makes the various administration pages for the module easier to
find in context.

It is up to date for Drupal 5.0. 


I have several comments and questions:


Under "Visibility," I see that hidden profile fields are "only
accessible by administrators, modules and themes." Admins may wonder,
How do themes deploy such fields?


Also under "Visibility, I see "Private field, content only available to
privileged users." Who are those "privileged users"? They seem to be
different from "administrators," but the "Permissions" page offers no
way to specify who they are. This is likely to perplex site
administrators. It should be documented.


Cordially,
O Govinda




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

Sun, 31 Dec 2006 13:20:33 +0000 : lreid

Attachment: http://drupal.org/files/issues/Revised help copy for profiles 2.txt (4.16 KB)

This looks great. I've made a couple of suggestions (I put them between
double slashes; I don't know what the protocol for inserting edits is
here). My suggestions should be checked against 5.0.


I don't know either how to write documentation for the privileged
fields, as I can't see how or where special access to those fields is
enabled. Is this a problem in the module?


Would it be possible to include here some indication for the admin who
wants to further customize profile display? Is
http://drupal.org/node/26478 the right place to send people for that? Or
more generically a statement that techniques x, y, or z can be used for
that (php snippets...I don't know what else, though I'd like to!)?


best,
Lynette




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

Mon, 01 Jan 2007 01:24:28 +0000 : sepeck

Nicer then the existing write up.  I'm not sure what the privileged
settings are either.  IN any case, I've bumped you up to handbook
maintainer so you can update the pages directly now.




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

Mon, 01 Jan 2007 13:32:02 +0000 : O Govinda

Many thanks for bumping me up.


Cordially,
O Govinda