opened
Hexcles
username_0
Although the link without the file extension works on Sphinx, it does not work
on GitHub. Adding the ".md" extension makes it work in both places.
Fix a dead link in docs
issue
created
Hexcles
username_0
@foolip mentioned he copied the syntax from somewhere else.

Turns out, we do have a lot of them, so let me push a more general change.
comment
created
Hexcles
username_0
In fact, we only have exactly two places where we add the `.md` extension:

```
running-tests/android_webview.md
9:Please check [Chrome for Android](chrome_android.md) for the common instructions for Android support first.

running-tests/from-local-system.md
121:\**See [Trusting Root CA](../tools/certs/README.md)*
```

All the other in-site links don't specify any extension. @username_1 was this intentional?
comment
created
Hexcles
username_0
This is the regex I used to find links without extensions (there are some false positive matches, but shouldn't have false negatives):

```
ag --markdown ']\(((?!\.md|http).)*\)'
```
comment
created
jugglinmike
username_1
Also, we can't support the GitHub.com view for links to documentation stored outside of the `docs/` directory ([currently, that's `tools/wptserve/`, `tools/certs/`, and `tools/wptrunner/`](https://github.com/web-platform-tests/wpt/blob/0b2fcd3261f03fd69acd345dc8c7e55e613f62d8/docs/Makefile#L23)).

It may be better to discourage use of that view rather than work to support it partially.
comment