Investigate migrating documentation to Stardoc

[Stardoc](https://github.com/bazelbuild/stardoc) is a documentation generator for Bazel rules, providers, and other definitions.

Currently, rules_go documentation is maintained separately from the rule implementation themselves, so it's easy for it to drift.

We should investigate whether Stardoc is a viable replacement for the current documentation. If it is, we should migrate the current documentation to generated Stardoc.

Analogous Gazelle issue bazelbuild/bazel-gazelle#763

Read the Stardoc project and compare its capabilities with the current rules_go documentation and rule implementation. Use the analogous Gazelle issue as context. Done means determining whether Stardoc is viable and, if so, migrating the current documentation to generated Stardoc.

Written by the indexing model from the issue text.