Read our latest article: "Forty releases in: what devrel.directory is now"

devrel.directory

Contributing to devrel.directory

What contributions are welcome, how changes land, and the editorial bar every page has to clear.

By Fabian HugUpdated

devrel.directory is an open resource, and contributions from people who do DevRel work are what keep it useful.

What contributions are welcome

  • Directory listings: tools, communities, and resources for the directory. The submit button on that page opens a pre-filled email with the expected fields.
  • Job posts: open DevRel roles for the job board. Free community listings go through the submit button there, which pre-fills an email to [email protected].
  • Employer nominations: companies that hire in DevRel but are not being watched yet. The board is built by re-reading a hand-maintained watchlist of employer job boards twice a week, so nominating a company adds every DevRel role it posts from then on rather than a single listing. Nominate an employer from the job board, with the company name and its careers page.
  • Event submissions: DevRel conferences and meetups for the events page, via the submit button on that page.
  • Docs improvements: corrections, sharper examples, or expanded sections anywhere in the knowledge base. Email [email protected] with the page and the change you have in mind.

How changes land

Every submission is reviewed by the maintainer before it goes live, against the criteria published in How we curate - reading that page first is the best way to get a submission accepted. Listings, events, and docs suggestions go to [email protected]; job posts go to [email protected]. Include the essentials up front - what it is, where it lives, and a line on why it belongs - and it will typically be live within a few days.

The editorial bar

Docs contributions are held to a concrete standard: specific guidance, real examples, numbers where they exist, and honest tradeoffs. Generic filler that could appear on any site gets rejected, even when it is well written. The bar is strict for a structural reason: every docs page ships verbatim into the site's AI-facing mirrors at /llms.txt and /llms-full.txt, and each page is served as raw Markdown at its own .md endpoint. Thin content therefore does not just read badly on the page - it degrades how AI assistants represent the site to developers who never visit it directly.

Getting help

On this page