Documentation issue: Repository Rules

Documentation URL: https://docs.bazel.build/versions/2.1.0/skylark/repository_rules.html

The example implementation of `local_repository` does not work with bazel 2.1.1 when "path" is specified as relative path to the calling workspace. Yielding error: "rule //external: must create a directory".

Manual inspection of the repository path found `repository_ctx.attr.path` being resolved as relative path to the repository directory instead of the workspace directory in `repository_ctx.symlink`.

Also, is there a way to manually resolve a path relative to workspace directory?

Start with the linked Repository Rules documentation and reproduce the `local_repository` example on Bazel 2.1.1 using a relative `path`. Then inspect the `repository_ctx.attr.path` and `repository_ctx.symlink` entry points to determine the path-resolution behavior; done means the example works or the documentation clearly explains the supported resolution method.

Written by the indexing model from the issue text.