Upgrade to Pro — share decks privately, control downloads, hide ads and more …

apidays New York 2023 - How to Make Your Docs S...

apidays New York 2023 - How to Make Your Docs Stand Apart, Ash Arnwine, Nylas

apidays New York 2023
APIs for Embedded Business Models: Finance, Healthcare, Retail, and Media
May 16 & 17, 2023

How to Make Your Docs Stand Apart
Ash Arnwine, Director of Developer Relations at Nylas

------

Check out our conferences at https://www.apidays.global/

Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8

Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io

Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/

apidays

June 29, 2023
Tweet

More Decks by apidays

Other Decks in Programming

Transcript

  1. Houston, we have a Docs problem Ash Ryan Arnwine, Director

    of Developer Relations, Nylas indieweb.social/@ashryan Re–commitment to developers through Docs
  2. 3

  3. 7 Leadership buy-In Where is this impacting customers today? Where

    is this putting strain on the organization? What do we lose if we don’t do this?
  4. Start Reactive Create open and clear lines of communication 🗣

    Uncover customer feedback whenever you can 🔎 Find and extinguish the fires 🔥
  5. Get Proactive Get involved in the PDLC/SDLC process 🔧 Establish

    efficient and repeatable workflows 📝 Draft a roadmap and get feedback 🚀
  6. 12 To Infinity and Beyond Going beyond words on a

    page to truly delight your developers
  7. 13 • Onboarding journeys • Naming things • Dev tools

    • Feedback tools • Technical and strategic SEO • Changelog and release notes • Docs features Docs is more than “Docs”
  8. 14

  9. 15 Great Docs at Work G2 Crowd review Nylas has

    been a great partner and their API has been a blessing that solved a lot of business issues for us. Also, it's documentation is by far more details than any other product out there.
  10. Key Takeaways • Assess your current situation • Get started

    now with what you have • Hire for well-rounded skill sets • Start reactive • Get proactive • Docs is more than “Docs”
  11. Helpful Resources • Book: Docs for Developers ◦ docsfordevelopers.com •

    Community: Write the Docs ◦ writethedocs.org • Blog post: “Experimenting with AI in DevRel” ◦ ashryan.io/experimenting-with-ai-in-devrel
  12. 20 Want to work with Nylas DevRel? • Developer Advocacy

    team • Developer Documentation team <- WE’RE HIRING
  13. We’re hiring • Technical Writer (Remote in U.S. or Canada)

    • Eng (ML, SRE, QA) • PMM • BDR • And more! nylas.com/careers