AsyncAPI Initiative
2022 Google Season of Docs with the OSS AsyncAPI community ❤️ #303
Replies: 14 comments 11 replies
-
|
Applications close tmw Friday, March 25, 2022. Google will announce accepted organizations on April 14, 2022, at 18:00 UTC.
|
Beta Was this translation helpful? Give feedback.
-
|
You're already in! I will be excited to work with you. |
Beta Was this translation helpful? Give feedback.
-
|
Wow, the best news! I'm currently going through the documentation, this would be really fun. |
Beta Was this translation helpful? Give feedback.
-
|
🌟🌟🌟 Happy Thursday, Docs contributors! ... guess who got accepted at GSoD? 😎 Meanwhile, join our "13_docs" and "temp-gsod-2022" slack channels for details on the next steps.
|
Beta Was this translation helpful? Give feedback.
-
|
Beta Was this translation helpful? Give feedback.
-
|
Hello @alequetzalli i am interested to join and be a part of the Project. |
Beta Was this translation helpful? Give feedback.
-
|
Take me in too for technical writing
…On Tue, 12 Apr 2022 at 02:36, theSultan ***@***.***> wrote:
Wow, the best news! I'm currently going through the documentation, this
would be really fun.
—
Reply to this email directly, view it on GitHub
<#303 (reply in thread)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/ANOWNVEPIIL5DA3GWCSJ52LVESH6RANCNFSM5RSX2R3A>
.
You are receiving this because you are subscribed to this thread.Message
ID: ***@***.***>
|
Beta Was this translation helpful? Give feedback.
-
|
You're in! All you have to do is follow the instructions above for joining the |
Beta Was this translation helpful? Give feedback.
-
|
Hi, |
Beta Was this translation helpful? Give feedback.
-
|
REMINDER: Google will announce accepted organizations tomorrow, on April 14, 2022, at 18:00 UTC. 👉🏾That said, I'll be running mentorship hours and even host an "OSS Docs mentorship program" this 2022 for anyone interested in contributing to the |
Beta Was this translation helpful? Give feedback.
-
|
Let’s goooo 🚀🚀🚀🚀 |
Beta Was this translation helpful? Give feedback.
-
Hi @alequetzalli I am interested in the mentorship program. Is there a discussion forum for this? I will like to join. Thanks |
Beta Was this translation helpful? Give feedback.
-
|
This sounds interesting to meee |
Beta Was this translation helpful? Give feedback.
-
|
Congratulations on being accepted AsyncAPI! woot woot |
Beta Was this translation helpful? Give feedback.
-
|
Hi @alequetzalli Does that mean the hiring process is complete? |
Beta Was this translation helpful? Give feedback.
-
|
Hello team and @alequetzalli I am Satyam Kumar, an open source enthusiast and 3rd year Computer Science and Engineering undergraduate at National Institute of Technology Hamirpur. Please let me know how to proceed. I really hope to work with the organisation and have a great summer ahead. |
Beta Was this translation helpful? Give feedback.
-
|
UPDATES: April 18 🎉 AsyncAPISpec Slack workspace ALL updates and instructions for participation will always be given in the |
Beta Was this translation helpful? Give feedback.
-
|
Hey @alequetzalli, can I still apply for the technical writer position from GSoD, or the participants are already selected? |
Beta Was this translation helpful? Give feedback.
-
|
Hey👋 @alequetzalli |
Beta Was this translation helpful? Give feedback.
-
|
I want to work as a technical writer @alequetzalli , how to apply? |
Beta Was this translation helpful? Give feedback.
-
|
I want to work as a technical writer @alequetzalli , how can I apply to your organization? |
Beta Was this translation helpful? Give feedback.
-
|
Hi Team and @alequetzalli, I am Yash Agrawal, Software Engineer @Shiprocket and previously contributed to Julia Docs Julia Docs. I hope I am not late for GSOD proposals. I have explored the AsyncAPI documentation and feel really excited to contribute to the project. Please guide me in the further process. Meanwhile, I will join all other channels. Thanks!! |
Beta Was this translation helpful? Give feedback.
-
|
Hey, I'm a contributor at AsyncAPI, would love to be a part of this. |
Beta Was this translation helpful? Give feedback.
-
|
I want to contribute as a TW to the organization through GSoD 2023 |
Beta Was this translation helpful? Give feedback.
-
🦄 Hola
¡Hola, AsyncAPI community! 😄
For today's latest announcement around AsyncAPI Docs 📑, I wanted to share with all technical writers about our organization’s plan for participation in
Google Season of Docs 2022 (GSoD). Any and all technical writers are welcome to come and participate with us for GSoD 2022 season, regardless of tech background or years of experience! At AsynAPI, we love mentoring folks who want to get involved in OSS, tech, and Docs. ❤️As some of you may remember from my Gist Docs update for 31 Jan - 11 Feb 2022, I noted that GSoD 2022 was coming up and that AsyncAPI wanted to participate in the application process once it opened on February 23, 2022.
In anticipation of this, I also created a new AsyncAPI Slack channel named
#temp-gsod-2022that anyone can join! First, join our Slack workspace ☎️ and please respect our slack etiquette.🙂 Then join thetemp-gsod-2022channel, our temporary channel to coordinate GSoD 2022 setup. I'll publish regular updates on where we are in the application process, so stay tuned as the process continues. 🙂Join the
#temp-gsod-2022slack channel for:Below is the project proposal we've submitted to
GSoD 2022and then we close with a reminder of how to get started as an AsyncAPI Docs contributor:🙌🏾 Update Docs Information Architecture - AsyncAPI Initiative
❤️ About AsyncAPI
AsyncAPI (currently version 2.3.0, first released in 2016) is an Apache License 2.0 library under the Linux Foundation that seeks to improve the current state of Event-Driven Architectures (EDA). The AsyncAPI Initiative is a specification and growing set of open-source tools to help developers define asynchronous APIs, and build and maintain event-driven architectures. Developers familiar with OpenAPI (aka Swagger) for RESTful APIs will see strong similarities when using AsyncAPI. One common use case is generating documentation (HTML or Markdown) of an asynchronous API. The specification is both platform and language agnostic. Current tooling includes support for common message brokers such as Apache Kafka and RabbitMQ, and languages including Python, Java, and Nodejs. Our long-term goal is to make working with EDAs as easy as working with REST APIs. That goes from documentation to code generation, from discovery to event management, and beyond. Our 150+ Open-Source (OSS) contributors are EDA enthusiasts from all around the world.
📑 About our Docs project
🔎 Our current Docs problem
Our current Docs and their Information Architecture (IA) needs a major makeover. The current content buckets are far from ideal and much basic content is missing to help onboard new contributors. Users new to our API spec need
/Conceptualdocs that explain our spec terminology in more detail with engineering diagrams: people often learn visually! We also have to move our CLI docs under the Docs upcoming newReferencecontent bucket; currently, we have a README version of CLI docs only. Similarly, we're adding a new and broader/Toolssection of documentation for our tools in individual tools' GitHub repositories, under a/docsdirectory. Those should still remain there and continue to be maintained, but they also need to be documented in our Docs in a less informal way than what you see in a README. In time, we also need to add many more tutorials (i.e. Websocket, Kafka, etc) and Use Cases and Troubleshooting Guides, under a newHow-Tosection.We also need to re-structure the Generator tool docs. Because this is one of our main tools, it's big enough to be it's own independent project for 2022 GSoD. Currently, our Generator docs need a major update, to better explain every single functionality of the Generator.
🎯 Our Docs project’s scope
We're already invested in utilizing the Diátaxis methodology for determining our content buckets (Concepts, Tutorials, Tools, How-To Guides, Reference). Along with this change, it makes sense to add new landing pages that introduce each content bucket. Each content bucket landing page could include cards featuring requested content from the community that still needs contributions. Then each card will read, "Contributors Needed."
AsyncAPI has several CLI and Tools markdown README documentation in miscellaneous GitHub repositories that we plan to migrate over to the main Docs site. This task is part of our goal for finalizing our 2022 AsyncAPI Docs Information Architecture makeover. We explain this in more detail in our previous OSS blog post titled "Change is coming to our AsyncAPI Developer Documentation". It's also extensively documented in our AsyncAPI Docs GitHub Project Board.
In addition, we want to also target improving the Generator tool docs that are only READMEs in a repo right now. The Docs for this one tool are a big enough job to merit being our 2nd proposed project for 2022 GSoD.
We're also writing voluntary OSS bi-weekly updates via GitHub Gists to speak about the latest updates made in the AsyncAPI Docs Ecosystem. Due to our commitment to investing time in gaining interest in our community and getting Google excited about us, we've made sure to maintain updates about our
Google Season of Docs 2022application too! In fact, you can take a look at the latest three where we made said mentions here in AsyncAPI Docs update (31 Jan - 11 Feb 2022), AsyncAPI Docs update (14 Feb - 25 Feb 2022), and AsyncAPI Docs update (28 Feb - 11 March 2022).📏 Measuring our Docs project’s success
We will partially measure success in the Docs project by capturing specific feedback about the IA changes via our soon-to-come new Docs Feedback card. We need this specific and granular feedback to make sure we listen and make changes according to what the community requests from Docs. In previous AsyncAPI Docs Gist updates, we've mentioned that Design contributors were teaming with Docs on
/websiteissue #453 for the ideation and development of our new feedback card that will be added at the bottom of each Docs page. What the community decided over the last 2 weeks was that theSubmit feedbackbutton in the card will publish the feedback anonymously via the AsyncAPI bot and create a new GitHub Discussion with said feedback:The other way we would consider the project successful is the number of our contributors and Docs PRs increased from 3 to 6 community members. Currently, a majority of our OSS contributor community focuses only on contributing code, but we would like to instill a greater interest in contributing to documentation that provides value for everyone.
⌛ Timeline
The project itself will take approximately 4-6 months to complete, depending on the different levels of knowledge from diverse technical writers (TW) that might get involved. (At AsyncAPI, we want to work with any TW, regardless of their years of experience. We have a passion for mentorship, and we do not wish to have a bar that would prevent any TW from contributing to our OSS Initiative. In fact, we look forward to potentially mentoring TW(s) who are completely new to tech and making them feel welcome!)
For our 2 projects, we would like to request a minimum of 2 TWs, so that we can work on both the CLI/Tools and Generator Docs.
The timeline would look as following:
first-time-ticketsto get each new TW contributor started.GSoD 2022. Each TW starts creating documentation for their individual issues assigned/selected.💸 Project budget
We have set aside 2 mentors for now, for our 2 projects: improving our IA and re-structuring our Generator Docs. Should we be selected, AsyncAPI would like to request from Google a US $5000 budget for each project. For both projects, the request then totals for a $10,000 budget.
👉🏽 Get started contributing to AsyncAPI Docs Today
Last but not least, don't forget that code isn't the only way to contribute to OSS; Dev Docs are a huge help that benefit the entire OSS ecosystem. At AsyncAPI, we value Doc contributions as much as every other type of contribution. ❤️
To get started as a Docs contributor:
🏷 Tag me in your AsyncAPI Doc PRs
Do you have a documentation contributor question and you're wondering how to tag me into a GitHub discussion or PR? Never fear!
Tag me in your AsyncAPI Doc PRs or GitHub Discussions via my GitHub handle,
alequetzalli🐙.-A.Q. 👩🏻💻 and Canela 🐕🦺
Beta Was this translation helpful? Give feedback.
All reactions