Skip to content
This repository was archived by the owner on Oct 7, 2025. It is now read-only.
This repository was archived by the owner on Oct 7, 2025. It is now read-only.

XLA developer guide renders git clone commands with HTML anchor tags #130

@christian-westbrook

Description

@christian-westbrook

Description

Hi! I encountered this today while looking at the developer guide for the xla repository hosted at https://openxla.org/xla/developer_guide:

Image

There are anchor tags embedded into these instructions for new developers to fork, clone, and configure the XLA repository that will cause the given commands to fail. Anyone unfamiliar with Git commands attempting to copy and paste these instructions could run into trouble. I took a look at the source for this page located at https://github.com/openxla/xla/blob/main/docs/developer_guide.md and found this Markdown content:

## Get the code

1.  Create a fork of the [XLA repository](https://github.com/openxla/xla).
2.  Clone your fork of the repo, replacing `{USER}` with your GitHub username:
    ```sh
    git clone https://github.com/{USER}/xla.git
    ```

3.  Change into the `xla` directory: `cd xla`

4.  Configure the remote upstream repo:
    ```sh
    git remote add upstream https://github.com/openxla/xla.git
    ```

These URLs look like correctly formatted Markdown to me, so my assumption is that there's a problem converting this content from Markdown to HTML.

Steps to reproduce

  1. Visit https://openxla.org/xla/developer_guide
  2. Scroll to "Get the code" section
  3. Notice the malformed git commands with HTML anchor tags

Environment

  • Browser: Chrome Version 139.0.7258.139 (Official Build) (64-bit)
  • Date observed: 8/25/2025

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions