Contributing to devrel.directory
What contributions are welcome, how changes land, and the editorial bar every page has to clear.
Contributing to devrel.directory
devrel.directory is an open resource, and contributions from people who do DevRel work are what keep it useful.
What contributions are welcome
- Docs improvements: corrections, sharper examples, or expanded sections anywhere in the knowledge base.
- Directory listings: tools, communities, and resources for the directory, submitted through the listing form.
- Job posts: open DevRel roles for the job board, submitted through the job form.
- Event submissions: DevRel conferences and meetups for the events page, submitted through the event form.
How changes land
The site lives at github.com/fabianhug/devrel-directory. Docs and code changes land as pull requests against that repository, which the maintainer reviews before merging. Listings, jobs, and events go through the issue forms above and are added the same way after review.
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.