I joined Postman, focusing on Open Source 👩🏼‍🚀
Tags: opensource, career, eventdriven, architecture
Published: 2021-08-30 14:53:10

Well… the unexpected happened!

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/5hrj7a5ilqpggcvzgkz7.png)

I joined Postman to focus on **Open Source** technologies. 

(I've been informed this makes me a *Postmanaut* 👩🏼‍🚀.)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/tu9wrq4jikfmuw1p457y.jpeg)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/quvif5txxnlvm6401ki7.jpeg)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/vfv1am0ocsuu2nyaph95.png)

## What is the new job about?

Being hired onto the Open Source (OSS) side of the Postman spaceship means I was **not** hired to work on the Postman product docs. (So joining Postman all-hands meetings or events are **not** required, cause I’m in one of the partner OSS teams.) 

Rather, I was hired directly by the OSS project maintainer team that owns the **[AsyncAPI](https://www.asyncapi.com/)** OSS initiative, which [moved under the Linux Foundation](https://www.linuxfoundation.org/en/press-release/linux-foundation-will-host-asyncapi-to-support-growth-and-collaboration-for-industrys-fastest-growing-api-spec/#:~:text=Menu%20Menu-,Linux%20Foundation%20Will%20Host%20AsyncAPI%20to%20Support%20Growth%20and,Industry's%20Fastest%2DGrowing%20API%20Spec&text=SAN%20FRANCISCO%2C%20Calif.%2C%20March,will%20host%20the%20AsyncAPI%20Initiative.). 

> If you're curious to learn more, Postman’s CEO and co-founder Abhinav Asthana wrote a [blog post](https://blog.postman.com/asyncapi-joins-forces-with-postman-future-of-apis/) in 2020 to announce their partnership with AsyncAPI.

My job here as Senior Technical Writer will be to own the [documentation for AsyncAPI](https://www.asyncapi.com/docs/getting-started). 

That said, I’ll delve in a [few streams](https://www.youtube.com/asyncapi) or conference talks as well, despite not being their DevRel person. New boss just happened to suggest the idea and I decided to remain open to it since it would be only OSS community focused events. (I’ve been taking a purposeful break from corporate/startup conference talks for over a year because I needed and wanted a **damn break**.) 

Thank you for the neat swag, Postman! 

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ddiwdjvz18d19cluidca.jpeg)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/j90uxpe7xi0al9vju1bt.jpeg)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/vlhmfkfx2uat3ixvlprx.jpeg)

### But...I'm also awaiting my **AsyncAPI swag** to arrive soon!

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/k4bgn8cv2wp3ucnyl18g.png)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/pj81b3tbafoic77d52f7.png)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/3h0r68sk5q6iw6fsf3ha.png)

### Wait, does Postman offer any cool benefits? 

Ooh you bet they do! 🚀👩🏼‍🚀

- $240/month lunch stipend: ergo, **FREE lunch for as long as I work here** 😜🍕🍕

- Up to $600/year reimbursed for wellness and health programs; I’m using mine for kickboxing 

- Up to $100/month for Internet bill

- Up to $200/year for Learning & Development (L&D) books 📚: applies to job-related, L&D literature of your choosing

- Asynchronous communication via Slack

- Remote WFH

- Very flexible schedule 

- Unlimited PTO

- Full medical benefits/401K account; they hope to start matching this year or next 🤞🏽 

- Charity/Foundation donation matching for an organization of your choice 🥰; I will be choosing **[Women for Afghan Women](https://womenforafghanwomen.org/)**, because we need to continue supporting Afghan Women during the current humanitarian crisis unrolling in Afghanistan this year.


## What is AsyncAPI?

[AsyncAPI](https://www.asyncapi.com/) is an OSS initiative that seeks to improve Event-Driven Architectures (EDAs), asynchronous API standardization, and asynchronous API developer tools. 

AsyncAPI was created to describe APIs that **don’t** use HTTP. AsyncAPI has a specification similar to OpenAPI: it uses JSON schema for modeling published and subscribed objects. 

EDAs like AsyncAPI are broker-centric. A broker is a piece of infrastructure in charge of **receiving messages** and **delivering them**. Brokers can store messages until they are delivered, making EDAs quite resilient to failures. Some examples of brokers are *RabbitMQ*, *Apache Kafka*, *Solace*, etc.

Wanna try an AsyncAPI playground?
https://playground.asyncapi.io


![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/m2xwsrdbvqo75zq5q66h.png)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ky4a65x33zozto7rnl8d.png)

```
asyncapi: '2.1.0'
info:
  title: Count Signups
  version: 1.0.0
  description: This service counts user signups
channels:
  user/signedup:
    subscribe:
      message:
        $ref: '#/components/messages/UserSignedUp'
components:
  messages:
    UserSignedUp:
      payload:
        type: object
        properties:
          displayName:
            type: string
            description: user name
          email:
            type: string
            format: email
            description: user email
```


![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zqvbjb7ta3m632s3w9ov.png)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zobk3hzcjvxux6fy6628.jpeg)

## Why am I excited about joining a 💯% OSS team?

Honestly, I am most excited about *not* having a Product Owner that feels pressured by an Engineering organization. 

Why?
- It’s been my experience that when Product Managers (PMs) or Engineering orgs own Technical Writer (TW) teams, Developer Documentation often suffers by getting caught between the conflicting priorities of opposite  teams.

- Engineering orgs tend to assume dev audiences know at least some basics. (**For the love of donuts 🍩 🍩 🍩... can we stop assuming what readers do or don’t know, have or haven’t installed, and have or haven't tested before?!?!**) 

- Engineering orgs tend to be arrogant in their programming knowledge and not place enough value on detailed and beginner guides. 

- Engineering orgs tend to forget that DevDocs need to make sense to non-programmers. (i.e. Not all PMs know how to program and not all readers are developers. I mean, do you **want** your Sales team empowered for success or don’t you?) 

- PMs tend to be too opinionated on voice, which consistently leads to stifling a tech writer’s individual style. 

- PMs can also focus too much on feature driven development that brings in more business vs prioritizing what the actual community freaking asked for.  

- PMs can lose perspective and forget that documentation should help ANYONE. That includes developers whose first language is *not* English. Forcing TWs who learnt English as their **second language** to ✨✨ magically ✨✨ write only in mind for USA audiences or English grammar enthusiasts is the **opposite** of inclusion and diversity. PMs need to understand that it’s a balancing act to tackle DevDocs and that keeping it simple to read matters!

- Having TW teams report into PM (or Engineering) orgs removes true ownership from TWs. TW teams need to have sole jurisdiction to do the job right. As long as TWs are reporting to *another* department, Developer Documentation goals will always be in competition with the parent org.  

Thank you for coming to my TED talk.🎤

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/k27m6uml95z79y46t8z2.png)

## What’s next?

I’m available for blog posts, articles, workshops, [videos](https://www.youtube.com/asyncapi), and talks about AsyncAPI, the AsyncAPI community, and how you too can [contribute to AsyncAPI](https://github.com/asyncapi).♥️ 

My main focus is [writing our Docs](https://www.asyncapi.com/docs/getting-started), but new boss supports variety, so I’m open to it.😃👍🏽 

I'll also make a point to help with community questions that come through our [AsyncAPI Slack channel](https://asyncapi.slack.com/join/shared_invite/enQtNDY3MzI0NjU5OTQyLTM5NTlkYzFmZDQyMGVkNzVkOTRhMGU2N2VmMWRlOTdkNWE0YzdjMGQ2NzRlOWU1NGJkYjUyZDEzMzM3ZGYzYzM#/shared-invite/email).

Lastly, we host and record [community interest meetings bi-weekly on Tuesdays](https://github.com/asyncapi/community). Meetings rotate from 4:00pm UTC one Tuesday and then 8:00am UTC the next Tuesday. Rotating the time of our bi-community meetings allows us to meet with community members from APAC, Europe and Americas. If you'd like to join me, all you have to do is [add our calendar](https://calendar.google.com/calendar?cid=dGJyYmZxNGRlNWJjbmd0OG9rdmV2NGxzdGtAZ3JvdXAuY2FsZW5kYXIuZ29vZ2xlLmNvbQ) or [join our mailing list](https://groups.google.com/forum/#!forum/asyncapi-users) to get an invite to the next meeting.


![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/10vx5lgng835h6ag1z4o.png)

## Let me know how I can help!
If you already have some **AsyncAPI** questions to send my way, I'm only a DM away here and in my social media. 

I can't wait to meet and support all of you awesome OSS community members!

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ke1944y0nl0hag86cdwc.png)

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/8aaq0kxump80okvwwzwf.png)