Add more comments to closure-templates-bazel files.

.gitignore

@@ -1,3 +1 @@
-bazel/
-bazel-bin/
 bazel*

BUILD

@@ -0,0 +1 @@
+# Intentionally empty. Needed by Bazel.

WORKSPACE

@@ -0,0 +1 @@
+# Intentionally empty.

closure_templates.bzl

@@ -1,3 +1,18 @@
+# Compiles the provided Soy files into JavaScript files. Each Soy file in the
+# srcs attribute will have a corresponding .soy.js file in the output.
+#
+# This rule expects the SoyToJsSrcCompiler.jar to be provided in a //tools/
+# directory in a Bazel filegroup rule called "soy_js_compiler".
+#
+# Arguments:
+#   - name: string, The name of this rule.
+#   - srcs: list of string, List of Soy source files.
+#   - should_provide_require_soy_namespaces: bool, Whether to output
+#     goog.provide and goog.require statements for each namespace in a Soy file.
+#     This is useful when used in conjunction with the Closure Library and
+#     Closure Compiler. Defaults to True.
+#   - visibility: list of string, List of Bazel packages that this rule is
+#     visible to.
 def soy_library(
     name,
     srcs,

demo/BUILD

@@ -1,3 +1,4 @@
+# This loads the Bazel macro for use in this BUILD file.
 load("/closure_templates", "soy_library")
 
 soy_library(

tools/BUILD

@@ -1,3 +1,5 @@
+# This filegroup makes the SoyToJsSrcCompiler.jar available for use by the
+# soy_library Bazel macro.
 filegroup(
     name = "soy_js_compiler",
     srcs = ["SoyToJsSrcCompiler.jar"],