--- layout: home title: Home ---
Skydoc is an easy-to-use documentation generator for Bazel build rules written in Skylark.
Get StartedDocument your Skylark rules with a familiar Python docstring format.
{% highlight python %} """An example documentation. Example: Here is an example of how to use this rule. Args: name: A unique name for this rule. srcs: Source files used to build this target deps: Dependencies for this target. Outputs: output_bin: The output binary. """ {% endhighlight %}Skydoc's own convenient Bazel build rules making it to integrate Skydoc into your build or release pipeline.
{% highlight python %} load("@io_bazel_skydoc//skylark:skylark.bzl", "skylark_doc") skylark_doc( name = "checkstyle-docs", srcs = ["checkstyle.bzl"], format = "html", ) {% endhighlight %}$ bazel build :checkstyle-docs
Generate documentation in Markdown or ready-to-serve, beautifully-crafted HTML pages.