Try to make the docs a little better. (#524)

* Try to make the docs a little better.
- Fix stardoc adding <p align=center> in markdown tables.
- Add rough capability to handle macros that wrap a rule.

The wrapping technique is:
- In the wrapping macro, use the docstring  @wraps(some_rule)
- Then we don't emit the docs for the wrapper
- In the docs for some_rule, replace the string "some_rule" with the
  name of the wrapper macro.

It is a first attempt to make things better.  It is crude, but it
mostly works.It is a first attempt to make things better. It is crude, but it mostly works. If Stardoc ever adds this capability [(feature request)[https://github.com/bazelbuild/stardoc/issues/120] we can move to that.
5 files changed
tree: 3854e4a3a05a87b2d7cb48109134fad2ee3bfa07
  1. .bazelci/
  2. deb_packages/
  3. distro/
  4. doc_build/
  5. docs/
  6. examples/
  7. pkg/
  8. tests/
  9. toolchains/
  10. .bazelignore
  11. .gitignore
  12. AUTHORS
  13. BUILD
  14. CODEOWNERS
  15. CONTRIBUTING.md
  16. CONTRIBUTORS
  17. deps.bzl
  18. developers.md
  19. install.bzl
  20. LICENSE
  21. mappings.bzl
  22. package_variables.bzl
  23. patching.md
  24. pkg.bzl
  25. providers.bzl
  26. README.md
  27. rpm.bzl
  28. version.bzl
  29. WORKSPACE
README.md

Bazel package building

Bazel rules for building tar, zip, deb, and rpm for packages.

Latest version: 0.6.0 Release Notes / Documentation

Use rules-pkg-discuss@googlegroups.com for discussion.

CI: Build status

Basic rules

Package building rules

  • pkg - Rules for building packages of various types.
  • examples - Cookbook examples for using the rules.

As of Bazel 4.x, Bazel uses this rule set for packaging its distribution. Bazel still contains a limited version of pkg_tar but its feature set is frozen. Any new capabilities will be added here.

For developers

We hold an engineering status meeting on the first Monday of every month at 10am USA East coast time. Add to calendar / meeting notes