 # application created within the framework. This very same template
 # is also used by the framework itself for the Cakefile of its own.
 # This method should satisfy the basic boilerplating needs of apps.
+# You would typically require this module and immediatelly invoke.
 module.exports = ->
 
     # Here follows the definition of the options required for some of
     # the tasks defined in this Cakefile. Remember that the scope of
     # definition of the options is global to a Cakefile, therefore the
     # options are shared among all of the tasks and the entire file!
+    # Please refer to `Cakefile` and `CoffeeScript` for information.
     option "-l", "--library [PATH]", "Path to the library sources"
     option "-m", "--modules [PATH]", "Path to the modules directory"
     option "-a", "--artifact [PATH]", "Path to the artifact directory"

    # the generation of the documentation for the library, using the
    # Groc documentation tool. The Groc depends on Pygments being set
    # in place, before running. Takes some minor options via CLI call.
    task "documents", "generate the library documentation", (options) ->
        assert library = options.library or DEFAULT_LIBRARY
        assert documents = options.documents or DEFAULT_DOCUMENTS

    # the compilatation of the library source code from CoffeeScript
    # to JavaScript, taking into account the supplied options or the
    # assumed defaults if the options are not supplied via CLI call.
    # Please see the implementation for some of the important details
    task "compile", "compile CoffeeScript into JavaScript", (options) ->
        assert library = options.library or DEFAULT_LIBRARY
        assert artifact = options.artifact or DEFAULT_ARTIFACT
