Documentation on website is hard to follow

bazelbuild / rules_pkg

Bazel rules for creating packages of many types (zip, tar, deb, rpm, ...)

Apache License 2.0

214 stars 167 forks source link

Documentation on website is hard to follow #820

Open tonyganchev opened 5 months ago

tonyganchev commented 5 months ago

Consider the screenshot below. Text in the tables is wrapped aggressively and very hard to read. Can you switch to a var-width layout or come up with alternative doc rendering? Further problem is that the tables are actually overflowing the available space as in:

tonyaiuto commented 5 months ago

I'm still hoping stardoc comes up with a new rendering tool.

dieortin commented 4 months ago

Having a sidebar with links to the different rules would also be great, I currently have to jump to the top and back down all the time