Update workspace name and README.

README.md

@@ -1,2 +1,43 @@
 # rules_verilog
-Utilities for working with Verilog within Bazel.
+
+Utilities for working with Verilog within [Bazel](https://bazel.build/).
+
+## gtkwave_wrapper
+
+Wrapper for [GTKWave](http://gtkwave.sourceforge.net/) to view traces generated by Bazel rules.
+
+## verilog_module
+
+Bazel representation of a Verilog module's source files, dependencies, and top module.
+
+```Starlark
+load("@rules_verilog//verilog:defs.bzl", "verilog_module")
+
+verilog_module(
+    name = "counter",
+    top = "counter",
+    srcs = ["counter.sv"],
+)
+
+verilog_module(
+    name = "counter_top",
+    top = "counter_top",
+    srcs = [
+        "counter_top.sv",
+    ],
+    deps = [":counter"],
+)
+```
+
+## WORKSPACE
+
+To incorporate `rules_verilog` into your project at the following to your `WORKSPACE` file.
+
+```Starlark
+load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
+
+http_archive(
+    name = "rules_verilog",
+    # See release page for latest version url and sha.
+)
+```

WORKSPACE

@@ -1 +1 @@
-workspace(name = "bazel_hdl")
+workspace(name = "rules_verilog")