Skip to content

Commit

Permalink
Merge branch 'master' into seo-guide
Browse files Browse the repository at this point in the history
  • Loading branch information
CBID2 authored Jul 14, 2024
2 parents 8fde226 + e013e93 commit 8b21d9c
Show file tree
Hide file tree
Showing 8 changed files with 96 additions and 40 deletions.
12 changes: 6 additions & 6 deletions AMBASSADORS_MEMBERS.json
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
[
{
"name": "Alejandra Quetzalli",
"name": "Quetzalli Writes",
"img": "https://avatars.githubusercontent.com/u/19964402?v=4",
"bio": "Alejandra Quetzalli is the upcoming author (2023) of the book titled 'Designing Developer Documentation as a Product', which will be published by the Apress Publishing Company. Alejandra has been in tech for 9 years, working with SEO, Paid Search, Full-Stack development, UX, Developer Relations, and Technical Writing (Engineering Documentation). She's currently a core OSS contributor for Docs, DevRel, and Community Building at AsyncAPI Initiative. She's also a member of the AsyncAPI Technical Steering Committee (TSC).",
"bio": "Quetzalli Writes is an author of the book titled 'Docs-as-Ecosystem', which was published by the Apress Publishing Company. Quetzalli has been in tech for 9 years, working with SEO, Paid Search, Full-Stack development, UX, Developer Relations, and Technical Writing (Engineering Documentation). She's currently a core OSS contributor for Docs, DevRel, and Community Building at AsyncAPI Initiative. She's also a member of the AsyncAPI Technical Steering Committee (TSC).",
"title": "DevRel & DevDocs @AsyncAPI",
"github": "alequetzalli",
"twitter": "QuetzalliAle",
"linkedin": "alejandra-quetzalli",
"github": "quetzalliwrites",
"twitter": "QuetzalliWrites",
"linkedin": "quetzalli-writes",
"company": "Postman",
"country": "πŸ‡²πŸ‡½",
"contributions": [
Expand Down Expand Up @@ -209,7 +209,7 @@
"twitter": "ivangsa",
"bio": "Java Architect with a deep understanding of Java, Spring-Boot, Spring-Cloud technologies, specializing in Domain-Driven Design (DDD) and Event-Driven Architectures creating Software Easy to Understand. Building ZenWave 360ΒΊ. ZenWave 360ΒΊ is a set of tools built on the foundations of Domain Driven Design and API-First principles for Event-Driven Architectures, to help you create software easy to understand. https://www.zenwave360.io/",
"linkedin": "ivangarciasainzaja",
"company": "SNGULAR",
"company": "IZERTIS",
"title": "Java Architect. Speaker. Building ZenWave 360Β°.",
"img": "https://avatars.githubusercontent.com/u/1246876?v=4",
"contributions": [
Expand Down
9 changes: 9 additions & 0 deletions Emeritus.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,12 @@ emeritus:
- arjungarg07
- boyney123
- Barbanio
- mcturco
- damaru-inc
- geraldloeffler
- ron-debajyoti
- char0n
- kieranm1999
- jefflufc
- lewis-relph
- emilianozublena
45 changes: 12 additions & 33 deletions MAINTAINERS.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -87,14 +87,13 @@
linkedin: emilianozublena
slack: U01LYC8PW0M
availableForHire: false
isTscMember: true
isTscMember: false
repos:
- asyncapi-php-template
- name: Fran MΓ©ndez
github: fmvilas
slack: U34F2JRRS
availableForHire: false
company: Postman
linkedin: fmvilas
isTscMember: true
repos:
Expand All @@ -103,22 +102,17 @@
- openapi-schema-parser
- asyncapi-react
- glee
- generator
- nodejs-template
- nodejs-ws-template
- parser-js
- playground
- spec
- spec-json-schemas
- website
- bindings
- name: Gerald Loeffler
github: geraldloeffler
linkedin: geraldloeffler
slack: U01P5QDLP0X
availableForHire: false
company: Salesforce
isTscMember: true
isTscMember: false
repos:
- bindings
- name: Jonas Lagoni
Expand Down Expand Up @@ -156,6 +150,7 @@
linkedin: laurentbroudoux
slack: U018NLDV5E1
availableForHire: false
company: Postman
isTscMember: true
repos:
- bindings
Expand All @@ -165,7 +160,7 @@
slack: U01BM49KL3Z
twitter: ldussart
availableForHire: false
company: Ineat
company: zatsit
isTscMember: true
repos:
- avro-schema-parser
Expand All @@ -178,45 +173,34 @@
company: Postman
isTscMember: true
repos:
- avro-schema-parser
- openapi-schema-parser
- chatbot
- diff
- cli
- generator-filters
- generator-hooks
- github-action-for-generator
- generator
- nodejs-template
- nodejs-ws-template
- parser-js
- playground
- spec
- spec-json-schemas
- template-for-generator-templates
- website
- bundler
- name: Maciej UrbaΕ„czyk
github: magicmatatjahu
availableForHire: false
linkedin: maciej-urbaΕ„czyk-909547164
slack: U01EB02BP7A
company: Postman
company: Travelping GmbH
isTscMember: true
repos:
- asyncapi-react
- chatbot
- cli
- converter-go
- event-gateway
- generator-react-sdk
- generator
- html-template
- markdown-template
- modelina
- parser-js
- parser-go
- playground
- server-api
- template-for-go-projects
- website
Expand All @@ -234,8 +218,7 @@
github: damaru-inc
availableForHire: false
slack: UH3B166TD
company: Solace
isTscMember: true
isTscMember: false
repos:
- java-spring-cloud-stream-template
- python-paho-template
Expand All @@ -247,12 +230,9 @@
linkedin: missy-turco-a476a6126
availableForHire: false
company: Postman
isTscMember: true
isTscMember: false
repos:
- brand
- design-system
- studio
- website
- name: Nektarios Fifes
github: nektariosfifes
linkedin: nektarios-fifes-372740220
Expand Down Expand Up @@ -366,7 +346,6 @@
slack: U02FP8WBFQE
linkedin: danielr
availableForHire: false
company: IBM
isTscMember: true
repos:
- java-template
Expand All @@ -376,7 +355,7 @@
availableForHire: false
slack: U02FT2TKM37
company: IBM
isTscMember: true
isTscMember: false
repos:
- java-template
- name: Tom Jefferson
Expand All @@ -385,15 +364,15 @@
slack: U02FPPCEH6H
availableForHire: false
company: IBM
isTscMember: true
isTscMember: false
repos:
- java-template
- name: Lewis Relph
github: lewis-relph
availableForHire: false
slack: U02G8MDDEF3
company: IBM
isTscMember: true
isTscMember: false
repos:
- java-template
- name: Semen Tenishchev
Expand All @@ -420,7 +399,7 @@
linkedin: rondebajyoti
availableForHire: false
company: Narvar
isTscMember: true
isTscMember: false
repos:
- modelina
- name: Ivan Garcia Sainz-Aja
Expand Down Expand Up @@ -458,7 +437,7 @@
twitter: vladimirgorej
availableForHire: false
company: SmartBear
isTscMember: true
isTscMember: false
repos:
- bindings
- spec
Expand Down
2 changes: 1 addition & 1 deletion code_of_conduct/coc-incident-resolution-procedures.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Once the report has been submitted, the AsyncAPI CoC Committee will confirm rece

The Jurisdiction of the CoC Committee is as follows:
- [AsyncAPI Initiative GitHub](https://github.com/asyncapi)
- [AsyncAPI Slack](asyncapi.slack.com)
- [AsyncAPI Slack](asyncapi.slack.com), including all external channels connected through [Slack Connect](https://slack.com/connect).
- AsyncAPI social networks: [Twitter](https://twitter.com/AsyncAPISpec), [LinkedIn](https://www.linkedin.com/company/asyncapi), [YouTube](https://www.youtube.com/asyncapi), [Twitch](https://www.twitch.tv/asyncapi), and [Mastodon](https://fosstodon.org/@AsyncAPISpec)
- AsyncAPI events: conferences, talks, workshops, etc.

Expand Down
49 changes: 49 additions & 0 deletions docs/donating-projects.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
## Donating Your Project

Donating your open-source project to an open-source initiative involves transferring ownership or stewardship to an organization that supports and promotes open-source software. It ensures the project's sustainability, attracts more contributors, and aligns it with broader community goals.

AsyncAPI initiative is open to receiving project donations that align with our goals and values. Before considering donating your project to the initiative, kindly visit our [AsyncAPI Roadmap](https://www.asyncapi.com/roadmap) to learn more about what we are looking at as a community in the near future.

### Project Licensing

Donating your project to an open-source organization like AsyncAPI can be exciting, hence why we need to ensure one of the most important parts of open-source projects, which is licensing.

The AsyncAPI Initiative uses the [Apache-2.0 license](https://www.apache.org/licenses/LICENSE-2.0), which ensures our projects are open-source and community-driven. Before considering putting your project up for donation, ensure your projectΒ usesΒ aΒ compatibleΒ open-sourceΒ license.

### Legal Consideration

All the projects under the AsyncAPI initiative are strictly community-driven. We've put legal consideration into donating projects to the initiative.

- We value Contributor License Agreements (CLAs) as they provide project maintainers with the necessary legal rights to distribute and modify code contributed by different individuals, ensuring protection for both maintainers and contributors.

- We make Intellectual Property (IP) Review essential when donating projects from organizations instead of individual contributors. It's crucial to verify ownership and the chain of title to ensure that no proprietary code or third-party IP is included, maintaining a clear and respectful process for all involved.

### Community Engagement

When donating your project to a community-driven initiative like AsyncAPI, you should understand that communication is an integral part of the initiative. Before donating your project, communication with the community has to be established.

Follow the instructions below to establish and involve the community in your project donation:

1. Visit [AsyncAPI Initiative Discussions](https://github.com/orgs/asyncapi/discussions).
2. Create a new discussion by clicking on `New discussion` and selecting the `Idea` category. Specify in the _title_ that you want to donate to an existing project. In the _description_, state the purpose of the new repository and why it should be part of the AsyncAPI organization. Here's a [sample discussion about donating an existing project](https://github.com/orgs/asyncapi/discussions/643).
3. Start a discussion with community members to discuss the project idea, specify if you want to use AsyncAPI CI/CD workflows, and volunteer to become a maintainer for that project. For better visibility, share the discussion in the `#general` channel on our Slack.
4. Answer questions from contributors and maintainers about your project. Ask relevant questions about your project donation.

### Project Migration

After a successful community engagement, we move on to the final phase of project migration. Establish a successful project migration via the following steps:

1. Visit the [AsyncAPI Community Repo](https://github.com/asyncapi/community) and open a [new issue](https://github.com/asyncapi/community/issues/new?assignees=&labels=enhancement&projects=&template=enhancement.yml&title=%5BFEATURE%5D+%3Cdescription%3E).
2. Write your project's details and include a summary of the community discussion for your project.
3. Tag the `@asyncapi/tsc_members` at the end of the proposal description and ask for a vote on migrating your project to the organization, because the Technical Steering Committee (TSC) must approve the project donation. Tagging TSC members notifies them to vote on the proposed project.
4. If the TSC approves the new repository, then either `@derberg` or `@fmvilas` complete the project migration to the AsyncAPI organization.
5. Configure the CI pipelines to match the initiative's standards, so that either `@derberg` or `@fmvilas`can run AsyncAPI CI/CD workflows that push basic GitHub Actions workflows to the newly donated project.
6. New maintainers are invited as repo admins.

### Post Donation Maintenance

Successfully donating a project doesn't mean the end of your journey with it. On the contrary, the post-donation phase is crucial for the sustained health and growth of the project. Ensure your project continues to thrive and benefits the community long after donation by implementing these key practices:

- **Ongoing Contributions**: Your involvement shouldn't stop with the donation. Continue actively contributing to the project by adding new features, refining existing functionalities, and fixing bugs. Demonstrating ongoing commitment encourages others to contribute as well.
- **Documentation Updates**: Keep the project's documentation up-to-date. Write documentation for installation, configuration, usage, and API reference materials. As the project evolves, it's essential that the documentation reflects these changes accurately to assist both new and existing users.
- **Community Support**: Engage with the community by offering support, answering questions, providing feedback on user suggestions, and addressing any concerns. A vibrant, supportive community is key to a project's sustainability.
5 changes: 5 additions & 0 deletions tweets/recurring-discuss-ideas/2024-07-01.tweet
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
Do you have some nice ideas for #AsyncAPI-related tools? Do you want to validate and share with the AsyncAPI community?

Drop it πŸ‘‡ and let us have an open discussion πŸš€

https://github.com/asyncapi/community/discussions/categories/ideas
7 changes: 7 additions & 0 deletions tweets/recurring-slack-link/2024-07-06.tweet
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
✨ Did you know #AsyncAPI is on Slack? ✨

Join our Slack workspace to chat with anyone from our Open-Source community!

πŸ”— asyncapi.com/slack-invite

Ask for help and help others too. πŸ’ͺ🏿πŸ’ͺ🏽🦾
7 changes: 7 additions & 0 deletions tweets/recurring-slack-link/2024-07-13.tweet
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
✨ Did you know #AsyncAPI is on Slack? ✨

Join our Slack workspace to chat with anyone from our Open-Source community!

πŸ”— asyncapi.com/slack-invite

Ask for help and help others too. πŸ’ͺ🏿πŸ’ͺ🏽🦾

0 comments on commit 8b21d9c

Please sign in to comment.