/* $Id: README.txt,v 1.1 2007-11-17 21:08:13 sun Exp $ */ Journal module adds additional fields to all forms in a Drupal site to allow developers and site administrators to record and track all actions that have been performed to setup a site or change its configuration. Journal is primarily useful for developers and site administrators working in a team environment. Since Drupal is a full-fledged content management framework, it is often not easy to communicate, track and audit all changes that have been applied to a site. Even without contributed modules one is able to build a totally customized site. As of now, all journal log entries have to be written manually. Thus, the significance of journal entries depends on the given information (by a human). Journal forces a user to enter information on system_settings_form's, because it is obvious that something in a site's configuration is about to be changed. The journal log is similar to the watchdog log. However, watchdog logs can be truncated or emptied at any time, so you would loose all journal entries. Only users granted the 'access journal' permission are able to add entries to the journal. Journal form fields may be disabled for certain forms, for example forms that are displayed in blocks, like the user login form. A possible usage for Journal module is to provide meaningful information for snapshots created with the Demo Site module. -- INSTALLATION -- * Copy journal module to your modules directory and enable it on the modules page. * Go to Administer -> User management -> Access control to allow users of certain roles to access the journal (which includes adding new journal entries). -- USAGE -- * On any form, you or your co-workers/team are submitting to alter site settings and features, enter a meaningful description of your action into the journal entry form field. * To view all changes, go to Administer -> Logs -> Journal entries -- AUTHORS -- Daniel F. Kudwien, dev@unleashedmind.com Stefan M. Kudwien, dev@unleashedmind.com