Skip to content

Commit

Permalink
DevRel Roadmap Content. (#7512)
Browse files Browse the repository at this point in the history
* copy for 40 topics

* 35 complete topics

* add 8 topics
  • Loading branch information
dansholds authored Nov 4, 2024
1 parent b82d791 commit e7ad915
Show file tree
Hide file tree
Showing 48 changed files with 345 additions and 48 deletions.
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Active Listening
# Active Listening

Active listening in developer relations is about genuinely engaging with the developer community to understand their needs, challenges, and feedback. It involves more than just hearing what is said; it requires attention to verbal cues, context, and non-verbal signals, as well as asking clarifying questions and reflecting on what has been shared. By actively listening, developer advocates can build trust, foster open communication, and gain insights that help shape better products, documentation, and community experiences, ultimately creating a more supportive and responsive environment for developers.

Learn more from the following resources:

- [@article@What is active listening?](https://hbr.org/2024/01/what-is-active-listening)
- [@article@7 Active Listening Techniques For Better Communication](https://www.verywellmind.com/what-is-active-listening-3024343)
9 changes: 8 additions & 1 deletion ...ata/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Analytics and Optimization
# Analytics and Optimization

When engaging with developer communities on social media, it's important to monitor your analytics in order to maximise the potential of your content. Platforms like X provide great analytics that help you keep an eye on which posts perform well with data such as impressions, likes, and shares.

Learn more from the following resources:

- [@article@What is social media analytics?](https://blog.hootsuite.com/social-media-analytics/)
- [@article@2024 Guide to X (Twitter) Analytics](https://blog.hootsuite.com/twitter-analytics-guide/)
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Animations & Graphics
# Animations & Graphics

Animations and graphics can be a great addition to your live streaming setup, especially if they're related to the brand that you're representing. Be aware though that excessive animations and graphics can take its toll on your machine and potentially result in a bad experience for viewers, so it's important to find the right balance.

Learn more from the following resources:

- [@video@How to Create Animated Overlays For Your Live Streams](https://www.youtube.com/watch?v=y6BykyZGUlE)
- [@video@How to Install & Use Overlays in OBS](https://www.youtube.com/watch?v=pxB9ET8gZH0)
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Animations & Graphics
# Animations & Graphics

Adding animations and graphics to your videos are a great way to retain users. Large creators in the developer community such as Fireship.io do this to great effect by having a mix of informative and humourous animations and graphics.

Learn more from the following resources:

- [@video@3 AMAZING Graphic Animations For Level UP Your Videos](https://www.youtube.com/watch?v=cnyQkr21oM8)
- [@video@Essential Motion Graphics for Youtube](https://www.youtube.com/watch?v=HH0VBOyht0E)
8 changes: 7 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,7 @@
# Anticipate Questions
# Anticipate Questions

When giving talks, especially at developer conferences or events, its important to anticipate the audience asking questions at the end of your talk. Being prepared to handle common questions related to your topic can help you with confidence and show that you're a subject matter expert when you answer them correctly. It's important however not to lie or give incorrect answers so make sure that if you don't know the answer, you're honest about it.

Learn more from the following resources:

- [@article@How to handle questions during a presentation](https://www.secondnature.com.au/blog/how-to-handle-questions-during-a-presentation)
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# API References
# API References

Adding API References to your products documentation is a key component and the most common reason for developers using documentation. When creating API documentation, ensure you add examples for the most common languages as well as any details around authorization and common issues faced.

Learn more from the following resources:

- [@article@What Is API Documentation?](https://blog.hubspot.com/website/api-documentation)
- [@video@API Documentation and Why it Matters](https://www.youtube.com/watch?v=39Tt1IkLiQQ)
4 changes: 3 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,3 @@
# APIs & SDKs
# APIs & SDKs

APIs (Application Programming Interfaces) and SDKs (Software Development Kits) are essential tools in developer relations as they provide the building blocks for developers to integrate and extend functionality within their own applications. An API allows developers to interact with a service or platform through a defined set of rules and endpoints, enabling data exchange and functionality use without needing to understand the underlying code. SDKs go a step further by offering a collection of pre-built libraries, tools, and documentation that simplify the process of developing with an API, reducing the time and effort needed to create robust integrations. Together, APIs and SDKs empower developers to quickly build and innovate, driving adoption and engagement with a platform.
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Audio
# Audio

Having good quality audio when live streaming or creating video content is a must, it is often said that viewers will accept lower quality video but poor audio is a deal breaker. Unfortunetly this often includes purchasing a good quality microphone although theres many improvements you can make to an existing setup such as streaming from a quiet location with good accoustics and applying filters in your software of choice.

Learn more from the following resources:

- [@article@How to Improve Your Live Stream Audio](https://www.soundproofcow.com/improve-live-stream-audio/)
- [@video@How to improve your live stream audio quality!](https://www.youtube.com/watch?app=desktop&v=_bTb0YqJX9w)
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Be Concise
# Be Concise

Being concise during a Q&A means delivering clear, direct answers that address the core of the question without unnecessary detail or digression. This approach respects the time of both the person asking and the audience, ensuring that key information is communicated effectively.

Learn more from the following resources:

- [@article@How to handle a Q&A](https://anthonysanni.com/blog/3-common-difficult-q-session-questions-turn-advantage)
- [@video@How to answer any presentation question](https://www.youtube.com/watch?v=lfiNFNTwFGU)
10 changes: 9 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,9 @@
# Blog Posts
# Blog Posts

Writing blog posts is about creating valuable, informative content that resonates with developers by addressing their interests, challenges, and learning needs. Effective blog posts should be well-structured, beginning with a clear introduction that outlines the problem or topic, followed by detailed, actionable insights, code examples, or step-by-step guides that help readers understand and apply the concepts. It’s essential to write in a clear, engaging tone that balances technical accuracy with readability, making sure to anticipate common questions and challenges developers might have.

Learn more from the following resources:

- [@article@How to Write an SEO Blog Post: 11 Key Tips](https://www.semrush.com/blog/seo-blog-post/)
- [@article@How to Write an Awesome Blog Post in 5 Steps](https://www.wordstream.com/blog/ws/2015/02/09/how-to-write-a-blog-post)
- [@video@How to Write a PERFECT Blog Post in 2024](https://www.youtube.com/watch?v=HoT9naGLgNk)
4 changes: 3 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,3 @@
# Blogging
# Blogging

Blogging is a strategic way to share knowledge, build credibility, and engage with the developer community. It involves writing content that educates, informs, or solves specific problems that developers face, such as tutorials, best practices, case studies, and product updates. Effective blogging should be both informative and approachable, using clear language, relevant examples, and practical insights that developers can easily apply.
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Building a Personal Brand
# Building a Personal Brand

Building a personal brand in developer relations is about establishing a unique and authentic presence that showcases your expertise, values, and contributions to the developer community. It involves consistently sharing knowledge, insights, and experiences through various channels such as blogs, social media, podcasts, or public speaking, while engaging in meaningful conversations and collaborations. A strong personal brand helps build credibility and trust, making it easier to connect with other developers, influencers, and potential partners.

Learn more from the following resources:

- [@article@A New Approach to Building Your Personal Brand](https://hbr.org/2023/05/a-new-approach-to-building-your-personal-brand)
- [@video@5 Steps to Building a Personal Brand You Feel Good About](https://www.youtube.com/watch?v=ozMCb0wOnMU)
10 changes: 9 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,9 @@
# Building SDKs
# Building SDKs

Building SDKs (Software Development Kits) involves creating a set of tools, libraries, and documentation that help developers easily integrate and interact with a platform or service. A well-designed SDK abstracts the complexities of an API, providing a streamlined, user-friendly interface that enables developers to focus on building their applications rather than handling low-level technical details. It should be intuitive, well-documented, and robust, offering clear examples, error handling, and flexibility to suit different use cases.

Learn more from the following resources:

- [@article@How to build an SDK from scratch: Tutorial & best practices](https://liblab.com/blog/how-to-build-an-sdk/)
- [@article@Guiding Principles for Building SDKs](https://auth0.com/blog/guiding-principles-for-building-sdks/)
- [@video@API vs SDK](https://www.youtube.com/watch?v=kG-fLp9BTRo)
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Code of Conduct
# Code of Conduct

Writing a code of conduct for developer communities involves setting clear guidelines that promote a safe, inclusive, and respectful environment for all participants. It should define acceptable behavior, outline unacceptable actions (such as harassment, discrimination, or disruptive conduct), and provide examples where necessary to clarify expectations. A well-crafted code of conduct also includes clear procedures for reporting violations, ensuring that community members know how to raise concerns and what they can expect in terms of response. Additionally, it should outline the consequences for breaking the rules, emphasizing that the guidelines are actively enforced to maintain a positive and welcoming community culture. The tone should be firm yet approachable, reflecting the commitment to fairness, safety, and inclusivity.

Learn more from the following resources:

- [@article@Guide to writing a Code of Conduct](https://projectinclude.org/writing_cocs)
- [@article@Code of Conduct meaning and template](https://humaans.io/hr-glossary/code-of-conduct)
8 changes: 7 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,7 @@
# Code Samples
# Code Samples

Code samples are essential in sample projects as they provide concrete, practical examples that help developers understand how to use a platform, library, or tool. Well-crafted code samples should be clear, concise, and focused on demonstrating specific functionality, avoiding unnecessary complexity that might distract from the core concept. They should be easy to read, following consistent naming conventions, proper formatting, and best practices for the relevant programming language. Including inline comments and explanations can help clarify key steps, while additional context in the accompanying documentation or blog post can guide developers through the logic and potential use cases.

Learn more from the following resources:

- [@article@Code Documentation Best Practices and Standards: A Complete Guide](https://blog.codacy.com/code-documentation)
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Collaborations
# Collaborations

Blogging collaborations involve partnering with other experts, influencers, or organizations to create content that combines diverse perspectives, expertise, and audiences. Collaborations can take the form of co-authored posts, guest blogging, or interview-style pieces, and they are an effective way to reach a broader audience while enriching the content with insights that a single author might not cover. Successful collaborations require clear communication, aligning on goals, topics, and responsibilities, and ensuring that the content feels cohesive and valuable to all parties involved. They also provide an opportunity to build relationships, share knowledge, and cross-promote, driving increased visibility and engagement for everyone participating.

Learn more from the following resources:

- [@article@How to collaborate with bloggers](https://www.create.net/blog/how-to-collaborate-with-bloggers)
- [@article@The Power of Collaborative Blogging: Building Relationships and Connecting with Others](https://aicontentfy.com/en/blog/power-of-collaborative-blogging-building-relationships-and-connecting-with-others)
8 changes: 7 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,7 @@
# Community Growth
# Community Growth

Growing a community is a multifaceted process that requires strategic planning, consistent engagement, and a focus on providing value to members. It involves creating a welcoming environment, fostering meaningful interactions, and continuously adapting to the needs and interests of the community. Key aspects include developing clear goals, establishing communication channels, organizing events, encouraging user-generated content, and leveraging data-driven insights to refine strategies. Successful community growth not only increases numbers but also enhances the quality of interactions, builds loyalty, and creates a self-sustaining ecosystem where members actively contribute to and benefit from the community's collective knowledge and resources.

Learn more from the following resources:

- [@video@ecrets to Building the Most Engaging Community Ever](https://www.youtube.com/watch?v=6ZVpufakwfk)
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Community Guidelines
# Community Guidelines

Community guidelines serve as the cornerstone of a thriving developer community, establishing essential rules and principles that govern interactions among members. By setting clear expectations for behavior and promoting respectful communication, these guidelines create a safe and inclusive environment where all participants can flourish. Covering a range of crucial topics such as code of conduct, content moderation, intellectual property rights, and dispute resolution, well-crafted guidelines provide a comprehensive framework for community engagement. Through the implementation and enforcement of these standards, communities can effectively foster collaboration, encourage knowledge sharing, and maintain a positive atmosphere. Ultimately, this supportive environment nurtures the growth and engagement of developers, contributing to the overall success and sustainability of the community.

Learn more from the following resources:

- [@article@Community Guidelines: How to Write and Enforce Them](https://www.commsor.com/post/community-guidelines)
- [@article@Community Guidelines Mastery: From Creation to Enforcement](https://bettermode.com/blog/community-guidelines)
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Community Management
# Community Management

Community management is a critical aspect of developer relations that involves nurturing and overseeing a thriving ecosystem of developers, users, and stakeholders. It encompasses a wide range of activities, including facilitating discussions, moderating content, organizing events, and implementing strategies to foster engagement and growth. Effective community managers act as bridges between the company and its users, ensuring that community needs are addressed while aligning with organizational goals. They cultivate a positive and inclusive environment where members can share knowledge, collaborate on projects, and provide valuable feedback, ultimately contributing to the success and evolution of the product or platform.

Learn more from the following resources:

- [@article@The Ultimate Guide to Community Management](https://blog.hubspot.com/marketing/community-management-expert-advice)
- [@article@Online Community Management Tactics](https://www.higherlogic.com/blog/online-community-management-guide/)
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Conference Speaking
# Conference Speaking

Conference speaking is a pivotal aspect of Developer Relations, offering a powerful platform for sharing knowledge, showcasing expertise, and fostering connections within the tech community. As a DevRel professional, mastering the art of public speaking allows you to effectively communicate complex technical concepts, inspire fellow developers, and represent your organization at industry events. This skill encompasses not only delivering engaging presentations but also crafting compelling narratives, tailoring content to diverse audiences, and navigating the intricacies of conference logistics. By honing your conference speaking abilities, you can significantly amplify your impact, establish thought leadership, and contribute to the growth and evolution of the developer ecosystem.

Learn more from the following resources:

- [@article@How to speak at a conference](https://www.eventible.com/learning/how-to-speak-at-a-conference/)
- [@video@Secrets of Great Conference Talks](https://www.youtube.com/watch?v=rOf5sPSBLjg)
9 changes: 8 additions & 1 deletion src/data/roadmaps/devrel/content/[email protected]
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Conflict Resolution
# Conflict Resolution

Conflict resolution in communities is a crucial skill for Developer Relations professionals, as it involves navigating and mediating disagreements that inevitably arise in diverse and passionate groups. This process requires a delicate balance of empathy, objectivity, and clear communication to address issues ranging from technical disputes to interpersonal conflicts. By fostering an environment of mutual respect and understanding, effective conflict resolution not only resolves immediate problems but also strengthens community bonds, encourages healthy debate, and promotes a culture of collaboration. Ultimately, the ability to skillfully manage conflicts contributes to the overall health and growth of the developer community, ensuring that differences of opinion become opportunities for learning and innovation rather than sources of division.

Learn more from the following resources:

- [@article@5 Conflict Resolution Strategies](https://www.indeed.com/career-advice/career-development/conflict-resolution-strategies)
- [@video@14 Effective Conflict Resolution Techniques](https://www.youtube.com/watch?v=v4sby5j4dTY)
Loading

0 comments on commit e7ad915

Please sign in to comment.