Skip to content

Commit e1240dc

Browse files
bandantonioasyncapi-botthulieblack
authored
docs: update/add weights and frontmatter for community docs (#1975)
Co-authored-by: Antonio <bandantonio@users.noreply.github.com> Co-authored-by: Chan <bot+chan@asyncapi.io> Co-authored-by: V Thulisile Sibanda <66913810+thulieblack@users.noreply.github.com>
1 parent 41efd0c commit e1240dc

File tree

94 files changed

+538
-99
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

94 files changed

+538
-99
lines changed

docs/000-onboarding/_section.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
---
2-
title: Onboarding guide
2+
title: Onboarding
33
weight: 10
44
---

docs/000-onboarding/ambassador-guide.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Onboarding Guide for AsyncAPI Ambassadors
3-
weight: 110
3+
weight: 50
44
---
55

66

@@ -38,4 +38,4 @@ Examples:
3838
- Our sincere gratitude and respect for your contributions!
3939

4040
### Additional resources
41-
[AsyncAPI Ambassador Program](https://github.com/asyncapi/community/blob/master/AMBASSADOR_ORGANIZATION.md)
41+
[AsyncAPI Ambassador Program](../050-mentorship-program/ambassador-program/AMBASSADOR_PROGRAM.md)
Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
---
2-
title: 'Docs onboarding checklist'
3-
weight: 30
2+
title: Docs Onboarding Checklist
3+
weight: 60
44
---
55
## AsyncAPI docs onboarding checklist
66

77
As an open-source initiative with a global community, technical writer contributors should learn about our governance documents, documentation processes, and communication channels.
88

99
Complete in order the following onboarding tasks:
1010

11-
- [ ] Read the [AsyncAPI Code of Conduct](https://github.com/asyncapi/community/blob/master/CODE_OF_CONDUCT.md).
12-
- [ ] Read the [AsyncAPI Slack etiquette](https://github.com/asyncapi/community/blob/master/slack-etiquette.md).
11+
- [ ] Read the [AsyncAPI Code of Conduct](https://github.com/asyncapi/.github/blob/master/CODE_OF_CONDUCT.md).
12+
- [ ] Read the [AsyncAPI Slack etiquette](../060-meetings-and-communication/slack-etiquette.md).
1313
- [ ] Join [the AsyncAPI Slack workspace](https://asyncapi.com/slack-invite).
1414
- [ ] Add the AsyncAPI calendar found in [the AsyncAPI events page](https://www.asyncapi.com/community/events).
15-
- [ ] Read the list of [technical writer contributor responsibilities](../010-contribution-guidelines/technical-writer-contributor-responsibilities).
16-
- [ ] Read and familiarize yourself with the [prerequisite knowledge topics](../010-contribution-guidelines/prerequisite-knowledge).
15+
- [ ] Read the list of [technical writer contributor responsibilities](../010-contribution-guidelines/technical-writer-contributor-responsibilities.md).
16+
- [ ] Read and familiarize yourself with the [prerequisite knowledge topics](../010-contribution-guidelines/prerequisite-knowledge.md).
1717
- [ ] Familiarize yourself with the _work-in-progress_ [AsyncAPI Style Guide](https://github.com/asyncapi/community/pulls?q=is%3Apr+is%3Aopen+style+guide).
1818
- [ ] Read all docs under the following content buckets: `Concepts`, `Tutorials`, `Reference`. (Take the time to go through each tutorial.)
19-
- [ ] Set up your local environment following our instructions for the [AsyncAPI git workflow](https://github.com/asyncapi/community/blob/master/git-workflow.md).
19+
- [ ] Set up your local environment following our instructions for the [AsyncAPI git workflow](../010-contribution-guidelines/git-workflow.md).
2020
- [ ] Introduce yourself in AsyncAPI Slack in the `#01_introductions` channel and the `#13_docs` channel. Ask docs-related questions in #13_docs.
2121
- [ ] Request a good first docs issue in the [`#13_docs` Slack channel](https://asyncapi.com/slack-invite).
2222
- [ ] Attend [OPEN docs meetings](https://www.asyncapi.com/community/events) to chat with other maintainers, ask docs questions, and request help on docs blockers.
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,8 @@
1+
---
2+
title: Documentarian Onboarding Guide
3+
weight: 30
4+
---
5+
16
🚧 This document is under construction.
27

38
Please be patient as we work on it. Thank you. 🫶
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: 'Utilizing GitHub Actions'
3-
weight: 140
2+
title: Utilizing GitHub Actions
3+
weight: 80
44
---
55

66
## Overview
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,8 @@
1+
---
2+
title: How to Contribute
3+
weight: 20
4+
---
5+
16
🚧 This document is under construction.
27

38
Please be patient as we work on it. Thank you. 🫶

docs/000-onboarding/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: 'Introduction'
3-
weight: 10
2+
title: Introduction
3+
weight: 5
44
---
55
## Technical writer onboarding guide
66

77
The AsyncAPI technical writer onboarding guide teaches new community members how to contribute to our documentation effectively.
88

9-
> For a comprehensive understanding of the various ways you can contribute to the AsyncAPI Initiative, please consult the [AsyncAPI contributing guidelines](https://github.com/asyncapi/community/blob/master/CONTRIBUTING.md).
9+
> For a comprehensive understanding of the various ways you can contribute to the AsyncAPI Initiative, please consult the [AsyncAPI contributing guidelines](../../CONTRIBUTING.md).
1010
1111
The goal is providing docs contributors with the necessary tools and knowledge to:
1212

docs/000-onboarding/maintainer-guide.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Onboarding Guide for AsyncAPI Maintainers
3-
weight: 100
3+
weight: 40
44
---
55

66

@@ -46,7 +46,7 @@ Before you can become a **maintainer**, you need to start as a **contributor**.
4646
4747
### 2. Open a PR
4848

49-
For a comprehensive guide on how to create a fork and start contributing, refer to the [AsyncAPI Git Workflow Guide](https://github.com/asyncapi/community/blob/master/git-workflow.md).
49+
For a comprehensive guide on how to create a fork and start contributing, refer to the [AsyncAPI Git Workflow Guide](../010-contribution-guidelines/git-workflow.md).
5050

5151
- **Fork the repository**: Fork the repository you want to contribute to and create a new branch for your changes.
5252

docs/onboarding-guide/upholding-code-of-conduct.md renamed to docs/000-onboarding/upholding-code-of-conduct.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: Upholding the Code of Conduct for new contributors
2+
title: Upholding the Code of Conduct
33
description: This onboarding guide outlines how to uphold the Code of Conduct document for new contributors
4-
weight: 160
4+
weight: 70
55
---
66

77
# Contributor Guide to Upholding the Code of Conduct
88

9-
Welcome to the AsyncAPI community! As a contributor, you are an essential part of building a safe, inclusive, and respectful environment for everyone. This guide will help you understand how to follow and uphold our [Code of Conduct](https://github.com/asyncapi/community/blob/master/CODE_OF_CONDUCT.md).
9+
Welcome to the AsyncAPI community! As a contributor, you are an essential part of building a safe, inclusive, and respectful environment for everyone. This guide will help you understand how to follow and uphold our [Code of Conduct](https://github.com/asyncapi/.github/blob/master/CODE_OF_CONDUCT.md).
1010

1111

1212

@@ -29,7 +29,7 @@ Following it helps:
2929
- **Be community-oriented:** Encourage collaboration, help others when you can, and gracefully accept constructive criticism.
3030
- **Speak Up:** If you witness inappropriate behavior, report it.
3131

32-
You are expected to read and understand the full [CoC](https://github.com/asyncapi/community/blob/master/CODE_OF_CONDUCT.md) before contributing.
32+
You are expected to read and understand the full [CoC](https://github.com/asyncapi/.github/blob/master/CODE_OF_CONDUCT.md) before contributing.
3333

3434

3535
## What to Do If You Experience or Witness a Violation
@@ -44,7 +44,7 @@ If you experience or observe discrimination, harassment, or any behavior that vi
4444
### 2. Report the Incident
4545
You can report a CoC violation by:
4646

47-
- Emailing **conduct@asyncapi.io** – this forwards directly to the [Code of Conduct Committee](https://github.com/asyncapi/community/blob/master/code_of_conduct/code-of-conduct-committee.md)
47+
- Emailing **conduct@asyncapi.io** – this forwards directly to the [Code of Conduct Committee](../CODE_OF_CONDUCT_COMMITTEE.md)
4848
- Reaching out to a specific CoC Committee member if the issue involves someone on the committee
4949

5050
All reports are handled with confidentiality, respect, and prompt action.
@@ -61,5 +61,5 @@ The Code of Conduct Committee is trained to resolve conflicts fairly and ensure
6161

6262

6363
## Additional Resources
64-
- [Incident Resolution Procedures](https://github.com/asyncapi/community/blob/master/code_of_conduct/coc-incident-resolution-procedures.md)
65-
- [Slack Etiquette Guidelines](https://github.com/asyncapi/community/blob/master/slack-etiquette.md)
64+
- [Incident Resolution Procedures](../COC-incident-resolution-procedures.md)
65+
- [Slack Etiquette Guidelines](../060-meetings-and-communication/slack-etiquette.md)
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,8 @@
1+
---
2+
title: Where to Contribute
3+
weight: 10
4+
---
5+
16
🚧 This document is under construction.
27

38
Please be patient as we work on it. Thank you. 🫶

0 commit comments

Comments
 (0)