[Checkins] SVN: Sandbox/ulif/grokintrospector/src/grok/admin/introspector/README.txt Add tests for the skins.

[Uli Fouquet]

Log message for revision 87461:
  Add tests for the skins.

Changed:
  A   Sandbox/ulif/grokintrospector/src/grok/admin/introspector/README.txt

-=-
Added: Sandbox/ulif/grokintrospector/src/grok/admin/introspector/README.txt
===================================================================
--- Sandbox/ulif/grokintrospector/src/grok/admin/introspector/README.txt	                        (rev 0)
+++ Sandbox/ulif/grokintrospector/src/grok/admin/introspector/README.txt	2008-06-17 14:28:17 UTC (rev 87461)
@@ -0,0 +1,49 @@
+grok.admin.introspector
+***********************
+
+Introspect objects and applications.
+
+:Test-Layer: functional
+
+Introduction
+============
+
+The grokadmin introspector is built upon ``zope.introspector``. Its
+purpose is to deliver in-depth information about applications, objects
+and other thing existing in a running Grok environment.
+
+Unlike ``zope.introspector`` this package also provides viewing
+components to display all the information retrieved. Furthermore we
+have the opportunity to get informed about aspects, which are specific
+for Grok and/or Zope 3 like lists of available directives, used
+grokkers etc.
+
+The Grok introspector is context-oriented. That means, that it is able
+to provide information about objects in specific contexts, so that you
+can for example get a list of available views in the context of a
+given skin/layer.
+
+Basic Usage
+===========
+
+Although the Grok introspector is context-oriented, it also provides
+an overview page as a starting point for general explorations of the
+whole runtime environment.
+
+Before we can access any pages, we have to initialize the test
+browser::
+
+  >>> from zope.testbrowser.testing import Browser
+  >>> browser = Browser()
+  >>> browser.addHeader('Authorization', 'Basic mgr:mgrpw')
+
+All introspector related content is shown in a special skin called
+``introspector``, so that you can enter the follwing URL to access the
+overview page::
+
+  >>> browser.open('http://localhost/++skin++introspector/')
+  >>> print browser.contents
+  The Overview
+
+Note the `++skin++introspector` marker in the URL.
+