asyncapi / asyncapi/website

[📑🐞 Docs Bug]: Broken external links in contributor documentation

Open Beginner friendly
#5,546 2 comments 0 reactions 0 assignees View on GitHub
📑 docs
Dominant language
TypeScript
Stars
716
Forks
1.2k
Avg merge
1d 12h
Merged PRs (30d)
35

Description

### Describe the bug you found in AsyncAPI Docs.

Several external links used across the AsyncAPI documentation are broken and return 404 pages.

The affected links point to:

- All Contributors documentation pages that were moved when the All Contributors website restructured its URLs from `/docs/en/` to `/en/reference/`
- The `TSC_MEMBERSHIP.md` file in the AsyncAPI Community repository, which was moved from the repository root to `docs/020-governance-and-policies/`

### Attach any resources that can help us understand the issue.

### Broken links

#### TSC Membership

**Old:**
[https://github.com/asyncapi/community/blob/master/TSC_MEMBERSHIP.md](https://github.com/asyncapi/community/blob/master/TSC_MEMBERSHIP.md)

**Current:**
[https://github.com/asyncapi/community/blob/master/docs/020-governance-and-policies/TSC_MEMBERSHIP.md](https://github.com/asyncapi/community/blob/master/docs/020-governance-and-policies/TSC_MEMBERSHIP.md)

#### All Contributors Specification

**Old:**
[https://allcontributors.org/docs/en/specification](https://allcontributors.org/docs/en/specification)

**Current:**
[https://allcontributors.org/en/reference/specification/](https://allcontributors.org/en/reference/specification/)

#### All Contributors Emoji Key

**Old:**
[https://allcontributors.org/docs/en/emoji-key](https://allcontributors.org/docs/en/emoji-key)

**Current:**
[https://allcontributors.org/en/reference/emoji-key/](https://allcontributors.org/en/reference/emoji-key/)

#### All Contributors Bot

**Old:**
[https://allcontributors.org](https://allcontributors.org)

**Current:**
[https://allcontributors.org/en/bot/](https://allcontributors.org/en/bot/)

### Code of Conduct

- [x] I agree to follow this project's Code of Conduct

### Are you willing to work on this issue?

Yes I am willing to submit a PR!

Contributor guide

Open the contributing guide

Research direction

Search the AsyncAPI website repository for the listed old All Contributors and TSC_MEMBERSHIP.md URLs, then inspect each matching contributor-documentation page. Replace them with the current URLs provided in the issue and verify that the updated links no longer return 404 pages.

Written by the indexing model from the issue text.

Assessment

Tech stack
nextjs, typescript
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.