Replace <code> with backticks in docs. Addresses bazel-contrib#255 (bazel-contrib#486)

Jonathon Belotti · web-flow · commit 6202ed2a68f1 · 2021-06-16T14:20:56.000+10:00
diff --git a/docs/packaging.md b/docs/packaging.md
@@ -97,7 +97,7 @@ py_wheel(
 | extra_requires |  List of optional requirements for this package   | <a href="https://bazel.build/docs/skylark/lib/dict.html">Dictionary: String -> List of strings</a> | optional | {} |
 | homepage |  A string specifying the URL for the package homepage.   | String | optional | "" |
 | license |  A string specifying the license of the package.   | String | optional | "" |
-| platform |  Supported platform. Use 'any' for pure-Python wheel.<br><br>If you have included platform-specific data, such as a .pyd or .so extension module, you will need to specify the platform in standard pip format. If you support multiple platforms, you can define platform constraints, then use a select() to specify the appropriate specifier, eg:<br><br>&lt;code&gt; platform = select({     "//platforms:windows_x86_64": "win_amd64",     "//platforms:macos_x86_64": "macosx_10_7_x86_64",     "//platforms:linux_x86_64": "manylinux2014_x86_64", }) &lt;/code&gt;   | String | optional | "any" |
+| platform |  Supported platform. Use 'any' for pure-Python wheel.<br><br>If you have included platform-specific data, such as a .pyd or .so extension module, you will need to specify the platform in standard pip format. If you support multiple platforms, you can define platform constraints, then use a select() to specify the appropriate specifier, eg:<br><br><code> platform = select({     "//platforms:windows_x86_64": "win_amd64",     "//platforms:macos_x86_64": "macosx_10_7_x86_64",     "//platforms:linux_x86_64": "manylinux2014_x86_64", }) </code>   | String | optional | "any" |
 | python_requires |  A string specifying what other distributions need to be installed when this one is. See the section on [Declaring required dependency](https://setuptools.readthedocs.io/en/latest/userguide/dependency_management.html#declaring-dependencies) for details and examples of the format of this argument.   | String | optional | "" |
 | python_tag |  Supported Python version(s), eg <code>py3</code>, <code>cp35.cp36</code>, etc   | String | optional | "py3" |
 | requires |  List of requirements for this package   | List of strings | optional | [] |
diff --git a/docs/whl.md b/docs/whl.md
@@ -32,9 +32,9 @@ This rule defines `@foo//:pkg` as a `py_library` target.
 | Name  | Description | Type | Mandatory | Default |
 | :-------------: | :-------------: | :-------------: | :-------------: | :-------------: |
 | name |  A unique name for this repository.   | <a href="https://bazel.build/docs/build-ref.html#name">Name</a> | required |  |
-| extras |  A subset of the "extras" available from this &lt;code&gt;.whl&lt;/code&gt; for which &lt;code&gt;requirements&lt;/code&gt; has the dependencies.   | List of strings | optional | [] |
+| extras |  A subset of the "extras" available from this <code>.whl</code> for which <code>requirements</code> has the dependencies.   | List of strings | optional | [] |
 | python_interpreter |  The command to run the Python interpreter used when unpacking the wheel.   | String | optional | "python" |
-| requirements |  The name of the &lt;code&gt;pip_import&lt;/code&gt; repository rule from which to load this &lt;code&gt;.whl&lt;/code&gt;'s dependencies.   | String | optional | "" |
-| whl |  The path to the &lt;code&gt;.whl&lt;/code&gt; file. The name is expected to follow [this convention](https://www.python.org/dev/peps/pep-0427/#file-name-convention)).   | <a href="https://bazel.build/docs/build-ref.html#labels">Label</a> | required |  |
+| requirements |  The name of the <code>pip_import</code> repository rule from which to load this <code>.whl</code>'s dependencies.   | String | optional | "" |
+| whl |  The path to the <code>.whl</code> file. The name is expected to follow [this convention](https://www.python.org/dev/peps/pep-0427/#file-name-convention)).   | <a href="https://bazel.build/docs/build-ref.html#labels">Label</a> | required |  |
 
 
diff --git a/python/packaging.bzl b/python/packaging.bzl
@@ -216,13 +216,13 @@ pip format. If you support multiple platforms, you can define
 platform constraints, then use a select() to specify the appropriate
 specifier, eg:
 
-<code>
+`
 platform = select({
     "//platforms:windows_x86_64": "win_amd64",
     "//platforms:macos_x86_64": "macosx_10_7_x86_64",
     "//platforms:linux_x86_64": "manylinux2014_x86_64",
 })
-</code>
+`
 """,
     ),
     "python_tag": attr.string(
diff --git a/python/whl.bzl b/python/whl.bzl
@@ -38,21 +38,21 @@ def _whl_impl(repository_ctx):
 whl_library = repository_rule(
     attrs = {
         "extras": attr.string_list(doc = """
-A subset of the "extras" available from this <code>.whl</code> for which
-<code>requirements</code> has the dependencies.
+A subset of the "extras" available from this `.whl` for which
+`requirements` has the dependencies.
 """),
         "python_interpreter": attr.string(default = "python", doc = """
 The command to run the Python interpreter used when unpacking the wheel.
 """),
         "requirements": attr.string(doc = """
-The name of the <code>pip_import</code> repository rule from which to load this
-<code>.whl</code>'s dependencies.
+The name of the `pip_import` repository rule from which to load this
+`.whl`'s dependencies.
 """),
         "whl": attr.label(
             mandatory = True,
             allow_single_file = True,
             doc = """
-The path to the <code>.whl</code> file. The name is expected to follow [this
+The path to the `.whl` file. The name is expected to follow [this
 convention](https://www.python.org/dev/peps/pep-0427/#file-name-convention)).
 """,
         ),
