• Home
Name Date Size #Lines LOC

..--

.bazelci/03-May-2024-2523

docs/03-May-2024-647479

stardoc/03-May-2024-582492

test/03-May-2024-3,3892,375

.gitignoreD03-May-2024225 2019

AUTHORSD03-May-2024305 107

BUILDD03-May-2024186 118

CODEOWNERSD03-May-202429 21

CONTRIBUTING.mdD03-May-20241.4 KiB2822

CONTRIBUTORSD03-May-2024586 1614

LICENSED03-May-202411.1 KiB203169

OWNERSD03-May-2024166 75

README.mdD03-May-20241.2 KiB3119

WORKSPACED03-May-20242.6 KiB7160

setup.bzlD03-May-20241.7 KiB4136

update-release-binary.shD03-May-20241.4 KiB3913

update-stardoc-docs.shD03-May-20241 KiB306

update-stardoc-tests.shD03-May-20241.9 KiB4820

README.md

1# Stardoc - Starlark Documentation Generator
2
3[![Build status](https://badge.buildkite.com/d8594eb71e4869c792cce22428b08e03b345f9c65dc603d70b.svg?branch=master)](https://buildkite.com/bazel/stardoc)
4
5Stardoc is a documentation generator for [Bazel](https://bazel.build) build rules
6written in [Starlark](https://bazel.build/docs/skylark/index.html).
7
8Stardoc provides a Starlark rule (`stardoc`, see [documentation](docs/stardoc_rule.md)) that can
9be used to build documentation for Starlark rules in Markdown. Stardoc generates one documentation
10page per `.bzl`file.
11
12## Get Started
13
14* How to [set up Stardoc for your project](docs/getting_started_stardoc.md)
15* Writing [docstrings](docs/writing_stardoc.md)
16* How to [integrate Stardoc with your build](docs/generating_stardoc.md).
17* See also [Advanced Topics](docs/advanced_stardoc_usage.md).
18
19## About Stardoc
20
21* Stardoc [rule reference](docs/stardoc_rule.md).
22* How to [contribute to Stardoc](docs/contributing.md)
23
24## Skydoc deprecation
25
26Stardoc is a replacement for the **deprecated** "Skydoc" documentation generator.
27
28See [Skydoc Deprecation](docs/skydoc_deprecation.md) for
29details on the deprecation and migration details.
30
31