Repository navigation
Commit 3c70c37
authored
Repoint dead TOSA links from mlplatform.org to their current homes (pytorch#22046)
### Summary
The website `www.mlplatform.org` is gone. Its DNS records were removed: the `mlplatform.org` zone is still published and `git.mlplatform.org` still resolves, but neither `www.mlplatform.org` nor the bare `mlplatform.org` has an address record any more, so nothing can connect to the website.
This repository links to three pages on that website from 13 places in 11 files, all in the Arm backend and its documentation. The URL linter (`scripts/lint_urls.sh`) reports all 13 as hard failures. Two things break as a result:
1. The nightly whole-tree link check is red every night.
2. `link-check / lint-urls` is a required check, and on a pull request it only extracts URLs from the lines that pull request adds. So any pull request that adds or rewrites one of these 13 link lines cannot merge, even when its actual purpose has nothing to do with links. Editing an unrelated line in the same file is not affected.
### Where the content went
It did not disappear, it moved. The last published copies of those three pages say where:
* The TOSA software page was an index of repositories on Arm's GitLab. Its "TOSA Serialization Library" entry pointed at `https://gitlab.arm.com/tosa/tosa-serialization`. That repository is itself deprecated now. Its README says it is no longer maintained and names `https://gitlab.arm.com/tosa/tosa-tools` as the new location, and its text still refers readers to the dead site. So these 8 links go to TOSA Tools instead. Arm folded three repositories into TOSA Tools, and serialization is one of them, so the reference is the same one at its current address. `tosa-reference-model` and `tosa-mlir-translator` carry the same deprecation notice.
* The TOSA overview and specification pages both name `https://github.com/arm/tosa-specification` as the home of the specification. That repository is public and actively updated.
So the links are repointed rather than suppressed:
| old (dead) | uses | new |
| --- | --- | --- |
| `/tosa/software.html` | 8 | `https://gitlab.arm.com/tosa/tosa-tools` |
| `/tosa/` and `/tosa/tosa_spec.html` | 3 | `https://github.com/arm/tosa-specification` |
| `/tosa/tosa_spec.html#_precision_scaling` | 1 | `.../blob/main/chapters/introduction.adoc#precision-scaling` |
| `/tosa/tosa_spec.html#_table` | 1 | `.../blob/main/chapters/ewise_binary.adoc#table` |
TOSA Tools is also what this repository already builds against: `.ci/scripts/unittest-linux-cmake.sh` clones `tosa-tools`, and the Arm backend pins the `tosa-tools` package.
The last two rows keep their deep link. The old site served a rendered HTML build of the specification, which no longer exists anywhere, but GitHub renders the AsciiDoc sources and generates heading anchors from the section titles, so those two fragments still land on the right sections.
The pages under `docs/source/backends/arm-ethos-u` and `docs/source/backends/arm-vgf` are generated from the templates in `backends/arm/scripts/docgen`, so both the template and the generated page are updated. Otherwise the next docgen run would undo this.
### Test plan
Ran the linter's whole-tree URL extractor against the tree before and after this change. Both runs find 2011 URLs, and the difference is exactly the 13 expected one for one replacements. No `www.mlplatform.org` reference remains, and no other URL is added, removed, or altered.
Checked each of the four new URLs the way the linter checks them, a HEAD request followed by a ranged GET, following redirects. All four answer 200.
For `gitlab.arm.com` a 200 does not on its own prove the page exists: that host answers 200 with a sign-in page for any path, including one made up as a control for this check. The GitLab target was therefore confirmed a second way, by fetching its README through the raw file endpoint, which does return 404 for a path that does not exist. `tosa-tools` returns its README, describing the serialization component. The same fetch against `tosa-serialization` is what returned the deprecation notice quoted above.
Confirmed that the two section fragments match anchors GitHub actually generates for those two files.
### Note for reviewers
All 11 files belong to the Arm backend, so please sanity check the choice of replacement targets.
One related link is left alone. `backends/arm/tosa/schemas/README.md` records that the FlatBuffer schema files originate from `https://git.mlplatform.org/tosa/reference_model.git/`. That host still resolves, so it is not failing CI, and it should stay as it is even if that host later goes away. It is a licence provenance statement about where the vendored files came from, not a pointer for a reader to follow, so repointing it at the reference model's current home in `https://gitlab.arm.com/tosa/tosa-tools` would state an origin that never happened. If it ever does start failing the linter, the right edit is to keep the original origin and note the current home beside it.1 parent ddfd169 commit 3c70c37
11 files changed
Lines changed: 13 additions & 13 deletions
File tree
- backends/arm
- _passes
- operators
- scripts/docgen
- ethos-u
- vgf
- docs/source/backends
- arm-ethos-u
- tutorials
- arm-vgf
- tutorials
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
24 | | - | |
| 24 | + | |
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
197 | 197 | | |
198 | 198 | | |
199 | 199 | | |
200 | | - | |
| 200 | + | |
201 | 201 | | |
202 | 202 | | |
203 | 203 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
31 | 31 | | |
32 | 32 | | |
33 | 33 | | |
34 | | - | |
| 34 | + | |
35 | 35 | | |
36 | 36 | | |
37 | 37 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
| 5 | + | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| |||
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
27 | | - | |
| 27 | + | |
28 | 28 | | |
29 | 29 | | |
30 | 30 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
43 | 43 | | |
44 | 44 | | |
45 | 45 | | |
46 | | - | |
| 46 | + | |
47 | 47 | | |
48 | 48 | | |
49 | 49 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
24 | | - | |
| 24 | + | |
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
48 | 48 | | |
49 | 49 | | |
50 | 50 | | |
51 | | - | |
| 51 | + | |
52 | 52 | | |
53 | 53 | | |
54 | 54 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
| 5 | + | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| |||
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
27 | | - | |
| 27 | + | |
28 | 28 | | |
29 | 29 | | |
30 | 30 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
43 | 43 | | |
44 | 44 | | |
45 | 45 | | |
46 | | - | |
| 46 | + | |
47 | 47 | | |
48 | 48 | | |
49 | 49 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
24 | | - | |
| 24 | + | |
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
| |||
0 commit comments