# advorel

> developer relation documentation and guide

- Documentation: https://pr-2-5bfc5f2f5cb7.thally.app
- GitHub: https://github.com/sammy-code98/advorel-thally-docs
- Full docs for LLMs: https://pr-2-5bfc5f2f5cb7.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-2-5bfc5f2f5cb7.thally.app/ai.txt
- Structured docs index (JSON): https://pr-2-5bfc5f2f5cb7.thally.app/api/docs-index
- OpenAPI spec: https://pr-2-5bfc5f2f5cb7.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-2-5bfc5f2f5cb7.thally.app/api/docs/{page-id}
- Search API: https://pr-2-5bfc5f2f5cb7.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-2-5bfc5f2f5cb7.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-2-5bfc5f2f5cb7.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-2-5bfc5f2f5cb7.thally.app/api/mcp
- Agent readiness: https://pr-2-5bfc5f2f5cb7.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## The Knowledge Base for Developer Advocates

### Welcome and Introduction

- [Welcome & Introduction](https://pr-2-5bfc5f2f5cb7.thally.app/): A community-built guide to Developer Relations, Developer Experience, advocacy, content, community, careers, and measurement.
- [What is DXMentorship?](https://pr-2-5bfc5f2f5cb7.thally.app/what-is-dxmentorship): Learn how DXMentorship helps aspiring Developer Relations practitioners build skills and experience.
- [Purpose of this Guide](https://pr-2-5bfc5f2f5cb7.thally.app/purpose-of-this-guide): Understand the guide's audience, scope, contribution model, and intended outcomes.
- [How to Contribute](https://pr-2-5bfc5f2f5cb7.thally.app/how-to-contribute): Contribute corrections, new pages, examples, and resources to the DX Guide.

### What is Developer Relations

- [What is Developer Relations?](https://pr-2-5bfc5f2f5cb7.thally.app/what-is-devrel): Understand how Developer Relations connects developer success, community insight, and product outcomes.
- [Definitions and Origins](https://pr-2-5bfc5f2f5cb7.thally.app/definitions-and-origins): Learn how Developer Relations developed and how its responsibilities have changed over time.
- [DevRel Core Pillars](https://pr-2-5bfc5f2f5cb7.thally.app/core-pillars): DevRel includes several complementary disciplines, from community and advocacy to education, support, and product feedback.
- [Why DevRel matters](https://pr-2-5bfc5f2f5cb7.thally.app/why-devrel-matters): Connect Developer Relations work to product adoption, feedback, trust, and ecosystem growth.

### Developer Advocacy

- [Developer Advocacy](https://pr-2-5bfc5f2f5cb7.thally.app/developer-advocacy): Explore the advocacy role in DevRel.
- [Public Speaking](https://pr-2-5bfc5f2f5cb7.thally.app/public-speaking): How Developer Advocates can choose speaking opportunities, structure technical talks, run safer demos, connect with an audience, and measure what happens after the talk.
- [Content Creation](https://pr-2-5bfc5f2f5cb7.thally.app/content-creation): A practical workflow for creating technical DevRel content that starts with developer problems, uses working examples, and reaches people where they already learn.
- [Developer Champions](https://pr-2-5bfc5f2f5cb7.thally.app/developer-champions): How to design ambassador and developer champion programs that recognize real community contribution, support people well, and extend Developer Relations without turning volunteers into unpaid staff.

### Developer Experience

- [Developer Experience](https://pr-2-5bfc5f2f5cb7.thally.app/developer-experience): Improving DX with tools, docs, and feedback.
- [Tooling DX Audits](https://pr-2-5bfc5f2f5cb7.thally.app/tooling-dx-audits): A practical way to find friction in a developer journey, prove it with evidence, and turn the findings into fixes developers can feel.
- [Documentation Best Practices](https://pr-2-5bfc5f2f5cb7.thally.app/documentation-best-practices): How DevRel teams can treat documentation as part of the developer experience, including practical guidance for using AI without giving up accuracy or empathy.
- [Feedback Collection](https://pr-2-5bfc5f2f5cb7.thally.app/feedback-collection): Collect, organize, route, and close the loop on feedback from developers.

### Community Building

- [Community Building](https://pr-2-5bfc5f2f5cb7.thally.app/community-building): Learn how to create useful, inclusive developer communities and sustain participation over time.
- [Community Building and Engagement](https://pr-2-5bfc5f2f5cb7.thally.app/online-community-management): Manage a welcoming developer community with clear purpose, participation paths, and healthy engagement.
- [Events and Meetups](https://pr-2-5bfc5f2f5cb7.thally.app/events-and-meetups): Plan developer events that create useful learning, connection, feedback, and follow-up opportunities.
- [Content and Knowledge Sharing](https://pr-2-5bfc5f2f5cb7.thally.app/content-and-knowledge-sharing): Create systems that help community members teach, learn, and contribute useful knowledge.

### Measuring DevRel Impact

- [Measuring DevRel Impact](https://pr-2-5bfc5f2f5cb7.thally.app/measuring-devrel): How to measure the impact of Developer Relations work with KPIs and metrics that matter.
- [KPIs and OKRs](https://pr-2-5bfc5f2f5cb7.thally.app/kpi-and-okrs): How DevRel teams can set goals that connect developer value to business outcomes without confusing activity with impact.
- [Qualitative vs Quantitative Metrics](https://pr-2-5bfc5f2f5cb7.thally.app/qualitative-vs-quantitative-metrics): How DevRel teams can combine numbers with developer stories to understand adoption, developer experience, community health, and business impact.
- [Reporting to Leadership](https://pr-2-5bfc5f2f5cb7.thally.app/reporting-to-leadership): How DevRel teams can turn activity, developer evidence, and business context into clear leadership reporting that supports decisions.

### Career Pathways in DevRel

- [Roles in DevRel](https://pr-2-5bfc5f2f5cb7.thally.app/roles-in-devrel): Understand how advocacy, community, content, and Developer Experience roles contribute to developer success.
- [Skills and Tools](https://pr-2-5bfc5f2f5cb7.thally.app/skills-and-tools): The practical skill set behind Developer Relations, plus a job-to-be-done approach for choosing tools without turning your workflow into a software collection.
- [Breaking into DevRel](https://pr-2-5bfc5f2f5cb7.thally.app/breaking-into-devrel): Follow a practical path into Developer Relations through skills, projects, content, and community participation.

### Case Studies and Stories

- [Real-Life Examples](https://pr-2-5bfc5f2f5cb7.thally.app/real-life-examples): How to turn real DevRel work into useful examples that show the problem, decisions, evidence, outcomes, and lessons instead of vague success stories.
- [Lessons Learned](https://pr-2-5bfc5f2f5cb7.thally.app/lessons-learned): A practical way to capture what DevRel work teaches you: including mistakes, trade-offs, weak signals, and the changes you make next.
- [Tools We Love](https://pr-2-5bfc5f2f5cb7.thally.app/tools-we-love): A small, practical DevRel toolkit organized around real jobs: research, documentation, visuals, video, community, and collaboration.

### Resources and Further Reading

- [Books](https://pr-2-5bfc5f2f5cb7.thally.app/books): A reading list for building practical Developer Relations knowledge.
- [Podcast and YouTube](https://pr-2-5bfc5f2f5cb7.thally.app/podcast-and-youtube): Explore selected podcasts and videos about Developer Relations practice and careers.
- [Communities to Join](https://pr-2-5bfc5f2f5cb7.thally.app/communities-to-join): Find communities where Developer Relations practitioners learn, share work, and build professional relationships.
- [Courses](https://pr-2-5bfc5f2f5cb7.thally.app/courses): A curated learning path for Developer Relations, technical writing, documentation, community, and practical portfolio building.

### Community Authors

- [Community Authors](https://pr-2-5bfc5f2f5cb7.thally.app/community-authors): The people contributing to the DXMentorship DevRel Guide, how we credit their work, and how new authors can contribute.

### Organizations

- [Advorel](https://pr-2-5bfc5f2f5cb7.thally.app/advorel): A practical look at Advorel, its public Developer Relations work, and the lessons contributed by people behind the projects featured in this guide.

### Deep Dives

- [Career Pathways in DevRel](https://pr-2-5bfc5f2f5cb7.thally.app/career-pathways): A practical map of Developer Relations career paths based on the work you enjoy, the problems you solve, and how your scope grows.
- [Case Studies & Stories](https://pr-2-5bfc5f2f5cb7.thally.app/case-studies): Case studies from DevRel and developer communities, written to show the problem, the work, the evidence, and the lesson.
- [Resources](https://pr-2-5bfc5f2f5cb7.thally.app/resources): Continue learning through selected external Developer Relations and Developer Experience collections.

### Jobs

- [Jobs in DevRel](https://pr-2-5bfc5f2f5cb7.thally.app/jobs-in-devrel): Compare common Developer Relations roles, responsibilities, and entry paths.
- [Job Search Strategies](https://pr-2-5bfc5f2f5cb7.thally.app/job-search-strategies): A practical way to find DevRel roles, read past inconsistent job titles, build evidence, and run a focused job search.
- [Interview Guide](https://pr-2-5bfc5f2f5cb7.thally.app/interview-guide): How to prepare for DevRel interviews that may test technical depth, teaching, writing, community judgment, strategy, and collaboration.
- [Portfolio Project Examples](https://pr-2-5bfc5f2f5cb7.thally.app/project-portfolio-examples): Practical DevRel portfolio projects that show how you teach, build, improve developer experience, run programs, and learn from evidence.

### DXMentorship Sessions

- [DXMentorship Sessions](https://pr-2-5bfc5f2f5cb7.thally.app/dx-mentorship-sessions): How to find, use, and contribute to DXMentorship learning sessions and turn live mentorship into a durable community knowledge base.

### Create Winning DevRel Resumes

- [DevRel resume](https://pr-2-5bfc5f2f5cb7.thally.app/devrel-resumes): Show technical communication, community work, and measurable evidence in a focused DevRel resume.
- [How To Structure Your DevRel Resume](https://pr-2-5bfc5f2f5cb7.thally.app/how-to-structure-your-devrel-resume): Organize a DevRel resume so hiring teams can quickly understand your skills and proof of work.

### LinkedIn and Personal Branding

- [Linkedin and Personal Branding](https://pr-2-5bfc5f2f5cb7.thally.app/linkedin-and-personal-branding): Build a credible LinkedIn presence that demonstrates your Developer Relations work.