[drupal-docs] Re: Comments on Admin Guide

[Boris Mann]

On Sun, 23 Jan 2005 11:09:58 -0800, Boris Mann <borismann at gmail.com> wrote:

> I moved the terminology page to the very top of the Admin Guide. The
> "basic concepts" at the top of the User Guide might be similarly
> reviewed/revamped.

http://drupal.org/node/937

OK, I actually re-wrote the top part of the terminology guide, as well
as added HTML comments on other areas that need improvement. Go ahead
and edit the page and leave your own HTML comments.

Basically, there is still some "developer" talk in there that is not
appropriate for an Admin Guide. Admins typically use Drupal only
through a web interface, although there are of course Admins who are
also developers or who do a certain amount of code work.

Man, we need per page/per-section to dos. To dos for terminology page:
* remove all references to code stuff
* consolidate theme/template/engine/style (perhaps under a theme sub-heading)
* potentially move all content types to different section, where both
core and contrib nodes can be explained (e.g. only explain "node",
then point to other section)
* explain input filters, point to in-depth discussion of filters
* basic explanation of taxo, vocab, and term, then point to in-depth
* permission stuff? users, roles, permissions

--
Boris Mann
http://www.bryght.com