# Website updates, missing link, needed

**URL:** <https://forum.crystal-lang.org/t/website-updates-missing-link-needed/3571>\
**Category:** Community\
**Created:** [July 30, 2021, 2:54am UTC](https://forum.crystal-lang.org/t/website-updates-missing-link-needed/3571 "2021-07-30T02:54:37Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![jzakiya](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/jzakiya/32/278_2.png) [@jzakiya](https://forum.crystal-lang.org/u/jzakiya)\
**Post date:** [July 30, 2021, 2:54am UTC](https://forum.crystal-lang.org/t/website-updates-missing-link-needed/3571/1 "2021-07-30T02:54:37Z")

</div>

While looking at the website homepage I found the link under the **MACROS** section gives a **404 Missing Page** error.

It probably should be this:

[https://crystal-lang.org/reference/syntax\_and\_semantics/macros/index.html](https://crystal-lang.org/reference/syntax_and_semantics/macros/index.html)

Also, under the **SYNTAX** section at the top, the link under it

[https://crystal-lang.org/reference/getting\_started/](https://crystal-lang.org/reference/getting_started/)

shows for the cli command `$ crystal --version` old 0.36.1.  
Probably good idea to update to current, to not confuse people what’s the latest.

---

<div class="post-metadata">

**Author:** ![straight-shoota](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/straight-shoota/32/36_2.png) [@straight-shoota](https://forum.crystal-lang.org/u/straight-shoota)\
**Post date:** [July 30, 2021, 10:00am UTC](https://forum.crystal-lang.org/t/website-updates-missing-link-needed/3571/2 "2021-07-30T10:00:00Z")

</div>

Yes, `https://crystal-lang.org/reference/syntax_and_semantics/macros.html` should be a redirect to `https://crystal-lang.org/reference/syntax_and_semantics/macros/index.html`.

> <https://github.com/crystal-lang/crystal-book/blob/121c5c572c5f6046a5aa85131489c986bef92062/mkdocs.yml#L47>

I don’t know why those `README.md` targets no longer work. Do we need to replace them with `index.html`? @oprypin any idea?

---

<div class="post-metadata">

**Author:** ![straight-shoota](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/straight-shoota/32/36_2.png) [@straight-shoota](https://forum.crystal-lang.org/u/straight-shoota)\
**Post date:** [July 30, 2021, 10:22am UTC](https://forum.crystal-lang.org/t/website-updates-missing-link-needed/3571/3 "2021-07-30T10:22:59Z")

</div>

I’ve created a PR to update version in crystal-book ([Update crystal-version by straight-shoota · Pull Request #533 · crystal-lang/crystal-book · GitHub](https://github.com/crystal-lang/crystal-book/pull/533)) and  
added instructions to update crystal version in the book to the release checklist ([Improve release checklist by straight-shoota · Pull Request #107 · crystal-lang/distribution-scripts · GitHub](https://github.com/crystal-lang/distribution-scripts/pull/107)).

---

<div class="post-metadata">

**Author:** ![oprypin](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/oprypin/32/859_2.png) [@oprypin](https://forum.crystal-lang.org/u/oprypin)\
**Post date:** [August 1, 2021, 5:44pm UTC](https://forum.crystal-lang.org/t/website-updates-missing-link-needed/3571/4 "2021-08-01T17:44:17Z")

</div>

I confirm this finding - redirects are broken.

```bash
.venv/bin/pip install -U mkdocs-redirects==1.0.2
make clean; make build

```

```auto
<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>Redirecting...</title>
    <link rel="canonical" href="macros/README.html">
    <meta name="robots" content="noindex">
    <script>var anchor=window.location.hash.substr(1);location.href="macros/README.html"+(anchor?"#"+anchor:"")</script>
    <meta http-equiv="refresh" content="0; url=macros/README.html">
</head>
<body>
Redirecting...
</body>
</html>

```

```bash
.venv/bin/pip install -U mkdocs-redirects==1.0.1
make clean; make build

```

```auto
<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>Redirecting...</title>
    <link rel="canonical" href="/reference/syntax_and_semantics/macros/index.html">
    <meta name="robots" content="noindex">
    <script>var anchor=window.location.hash.substr(1);location.href="/reference/syntax_and_semantics/macros/index.html"+(anchor?"#"+anchor:"")</script>
    <meta http-equiv="refresh" content="0; url=/reference/syntax_and_semantics/macros/index.html">
</head>
<body>
Redirecting...
</body>
</html>

```

> <https://github.com/crystal-lang/crystal-book/pull/526/files#diff-4d7c51b1efe9043e44439a949dfd92e5827321b34082903477fd04876edb7552R35>

---

<div class="post-metadata">

**Author:** ![oprypin](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/oprypin/32/859_2.png) [@oprypin](https://forum.crystal-lang.org/u/oprypin)\
**Post date:** [August 1, 2021, 6:27pm UTC](https://forum.crystal-lang.org/t/website-updates-missing-link-needed/3571/5 "2021-08-01T18:27:18Z")

</div>

> <https://github.com/crystal-lang/crystal-book/pull/534>
>
> Due to a bug, redirects to "README.md" are no longer recognized correctly as "in…dex.html":
> https://github.com/datarobot/mkdocs-redirects/issues/23
