Mention tw2.core.DirLink in the docs. Fixes #69.

docs/design.rst

@@ -166,6 +166,7 @@ To define a resource, just add a :class:`tw2.core.Resource` subclass to the widg
 .. autoclass:: tw2.core.CSSSource
 .. autoclass:: tw2.core.JSLink
 .. autoclass:: tw2.core.JSSource
+.. autoclass:: tw2.core.DirLink
 
 Resources are widgets, but follow a slightly different lifecycle. Resource subclasses are passed into the :attr:`resources` parameter. An instance is created for each request, but this is only done at the time of the parent Widget's :meth:`display` method. This gives widgets a chance to add dynamic resources in their :meth:`prepare` method.
 

tw2/core/resources.py

@@ -191,6 +191,15 @@ def __repr__(self):
 
 
 class DirLink(Link):
+    ''' A whole directory as a resource.
+
+    Unlike :class:`JSLink` and :class:`CSSLink`, this resource doesn't inject
+    anything on the page.. but it does register all resources under the
+    marked directory to be served by the middleware.
+
+    This is useful if you have a css file that pulls in a number of other
+    static resources like icons and images.
+    '''
     link = Variable()
     filename = Required
     whole_dir = True