Documentation issue: Rules Tutorial

[rosasco-wk]

Documentation URL: https://docs.bazel.build/versions/main/skylark/rules-tutorial.html

The above page says: "In the implementation function, the target will be accessible as a Target object. For example, view the files returned by the target using Target.files."

This needs a clarification / supporting example. Target.files isn't defined in the implementation function.

[rosasco-wk]

More generally, the segue to the "Dependencies" section could be a lot smoother. The first thing mentioned is "dependency attributes" without defining dependency attributes. Would be a good idea to have a simple example of establishing a dependency for the rule by showing an example of a dependency attribute in use.

[brandjon]

Wait, this is rules api.