Devrelshow Episode 25 - William Imoh  🔗 **Source:** [Devrelshow Episode 25 - William Imoh](https://youtube.com/live/TfqnaYssa24?si=loowydBE77zorycf) > [!note]+ Document Notes > tags: > - #developerAdvocacy > - #technicalWriting > - #contentStrategy > Author: Merlin > Source: [Merlin's YouTube Channel](https://merlin.foyer.work) > Reference: [Video Transcript](https://www.youtube.com/watch?v=TfqnaYssa24) > date created: 2024-10-20 20:45 > > # Title: The Role of Technical Writing in Developer Advocacy: Insights from William Imoh > <!-- deep-read:sections start --> ## Table of Contents: - [📝 Summary](#-summary) - [📖 Main Content](#-main-content) - [🗒️ Notes](#-notes) - [📖 References](#-references) - [🗣️ Paraphrase](#-paraphrase) - [📰 Newsletter](#-newsletter) - [✅ Action Items](#-action-items) - [🧪 Hypotheses](#-hypotheses) - [📊 Methodology](#-methodology) - [❓ Questions](#-questions) - [🔮 Future Research](#-future-research) - [💡 Implications](#-implications) - [🧠 Learning Styles Assessment](#-learning-styles-assessment) - [📊 Accessibility Assessment](#-accessibility-assessment) - [🌍 DEIB (Diversity, Equity, Inclusion, and Belonging) Assessment](#-deib-diversity-equity-inclusion-and-belonging-assessment) - [✅ Logical Validity](#-logical-validity) - [🔍 SEO Evaluation](#-seo-evaluation) - [🎯 Conclusion](#-conclusion) ### References: - [Merlin’s YouTube Video](https://merlin.foyer.work) ## 📝 Summary: In this episode of DevRelShow, William Imoh shares his journey into developer advocacy and technical writing, exploring how critical written content is in driving product adoption and growth. He discusses key strategies for creating valuable technical content, the importance of understanding audience personas, and how developers can transition into full-time writing roles while balancing AI's rise in content creation. The episode provides actionable insights for both technical writers and developer advocates. ## 📖 Main Content: William Imoh explains how his experience in web development and technical content creation led him to found Hack Mamba, a company focused on helping software teams grow through developer-centric writing. William highlights the significance of creating content tailored to different stages of the buyer’s journey, emphasizing storytelling, technical expertise, and SEO considerations. He also talks about the growing role of AI in content writing, stressing that while AI can assist, human writers remain essential for creating nuanced, product-focused content. ### 🗒️ Notes: - **Developer Advocacy Journey**: William began as an indie developer advocate, writing content and organizing meetups. - **Hack Mamba**: His company provides content for software teams, focusing on documentation and technical marketing. - **AI in Technical Writing**: AI is useful for assisting, but quality content requires human storytelling and expertise. - **Content Funnels**: Understanding top, middle, and bottom-funnel content is key to driving user engagement and conversions. - **Technical Writer Skills**: Code proficiency, SEO knowledge, and user persona understanding are essential for success. - **Content Optimization**: Regularly update content to reflect new product features and maintain accuracy. ## 📖 References: - [Merlin YouTube Transcript](https://merlin.foyer.work) ## 🗣️ Paraphrase: 1. William emphasizes that the foundation of technical content creation lies in understanding the developer’s journey and their specific context when integrating new tools. Rather than focusing solely on product details, successful content should consider the user’s goals and challenges. 2. He also highlights the importance of continuous learning for technical writers, pointing out that writing well isn’t enough—you need to understand SEO, marketing funnels, and how to tailor content for specific user personas. ## 📰 Newsletter: 🎉 **Developer Advocacy: The Future of Technical Writing** In this week's issue, we dive deep into the growing role of technical writing in developer advocacy, featuring insights from William Imoh, founder of Hack Mamba. Learn how AI is reshaping content creation (spoiler: human writers are still essential!) and discover new strategies for creating effective technical content that drives product adoption. Plus, tips on writing better documentation and updates on the latest WordPress plugins and tools. Don’t miss it! 👉 [Read more](#) ## ✅ Action Items: As a Developer Advocate with a strong educational background, integrating William’s approach to content creation into your advocacy strategy aligns perfectly with your goals. Focus on helping contributors improve their technical documentation skills, while promoting sustainable open-source development through educational content. Use insights from Hack Mamba's methodology to enhance transparency and inclusivity in the WordPress ecosystem. ## 🧪 Hypotheses: - Technical writing focused on product-specific challenges leads to faster integration times. - AI-generated content will remain less effective than human-written content for developer-centric needs due to its lack of real-world context. ### 📊 Methodology: - **Case Study Analysis**: Compare user engagement and satisfaction between AI-generated content and human-written technical guides. - **Surveys**: Gather feedback from developers on the usability of documentation that includes storytelling versus standard API references. ### ❓ Questions: - How can AI assist in creating top-of-funnel content without sacrificing the personal touch of human writers? - What tools can be developed to better support technical writers in tailoring content for specific developer personas? ### 🔮 Future Research: Research could focus on how AI-driven content platforms might assist technical writers in speeding up repetitive tasks while preserving the quality and personal touch in complex areas such as API documentation and developer tutorials. ### 💡 Implications: If AI can be harnessed effectively for content creation, the time saved on lower-level writing tasks could allow human writers to focus on higher-level strategic content. This would advance the field of technical writing, making it both more efficient and personalized. ### 🧠 Learning Styles Assessment: 1. **Visual Learners (Spatial)**: - **Present**: The article includes some diagrams and visual cues, but more infographics on content funnels and user personas could improve comprehension. - **Improve**: Incorporate flowcharts that depict the content creation process and its role in the developer journey. 2. **Aural Learners (Auditory-Musical)**: - **Present**: Opportunities for auditory learners are limited. - **Improve**: Consider adding podcast episodes or audio summaries to make the material more accessible. 3. **Verbal Learners (Linguistic)**: - **Present**: The content is descriptive and includes strong examples. - **Improve**: Further enrich with analogies and deeper storytelling elements. 4. **Physical Learners (Kinesthetic)**: - **Improve**: Suggest hands-on exercises like writing API documentation or creating a tutorial. 5. **Logical Learners (Mathematical)**: - **Present**: Step-by-step progressions in content funnels and developer personas are provided. - **Improve**: Include more case studies and data points to appeal to analytical learners. 6. **Social Learners (Interpersonal)**: - **Present**: Engagement opportunities in the form of discussions or collaboration aren’t explicitly encouraged. - **Improve**: Encourage group discussions around improving technical writing. 7. **Solitary Learners (Intrapersonal)**: - **Present**: Reflection points are present but could be expanded with journaling prompts or individual assessments. 8. **Naturalistic Learners**: - **Present**: Limited reference to environmental or nature-based analogies. - **Improve**: Use nature-based analogies to explain content funnels or content growth patterns. ### 📊 Accessibility Assessment: - **Screen Reader Compatibility**: Ensure all images and diagrams include alt-text descriptions for better accessibility. - **Keyboard Navigation**: Content appears navigable, but ensuring that all interactive elements are accessible via keyboard could improve usability. - **Contrast and Readability**: Ensure high contrast for readability, particularly for users with visual impairments. ### 🌍 DEIB (Diversity, Equity, Inclusion, and Belonging) Assessment: - **Cultural Relevance**: Examples provided mostly apply to Western tech industries. Incorporating diverse examples from different global regions would increase inclusivity. - **Inclusive Language**: Gender-neutral language is well used, though some complex jargon could be better explained for non-native speakers. - **Neurodiversity Support**: Consider breaking down long paragraphs into smaller, more digestible pieces to support readers with ADHD or other neurodiverse conditions. ### ✅ Logical Validity: - **Positive Reasoning**: The argument that developers need content that addresses their specific challenges is sound, as this type of content has a direct impact on user success. - **Logical Fallacies**: None identified. The structure and argument flow are clear and coherent. ### 🔍 SEO Evaluation: 1. **Keywords**: Strong use of relevant keywords such as "technical writing," "developer advocacy," and "content strategy." 2. **Meta Description**: Ensure the meta description includes primary keywords and effectively summarizes the article. 3. **Title Tag**: The title tag could be optimized to include keywords like “technical writing for developers” to improve SEO. 4. **Headers (H1, H2, H3)**: Header structure is used effectively but could incorporate more variations of key terms for better optimization. ## 🎯 Conclusion: Technical writing is an integral part of developer advocacy, offering value to both product adoption and developer education. While AI can assist in content creation, human writers are essential for producing nuanced, product-specific content that resonates with developers. Ensuring technical documentation is well-written, optimized for SEO, and tailored to various user personas will remain a key strategy for companies aiming to grow their developer communities. Short Summary for [devrelshow episode 25 - William Imoh](https://www.youtube.com/watch?v=TfqnaYssa24) by [Merlin](https://merlin.foyer.work/) "devrelshow episode 25 - William Imoh, Founder of Hack M, Discusses Technical Content Creation and Software Engineering" [00:15](https://www.youtube.com/watch?v=TfqnaYssa24&t=15) Introducing William Imoh on the Devo show. [02:38](https://www.youtube.com/watch?v=TfqnaYssa24&t=158) William Imoh is the founder of hack M and helps software teams with technical content. [07:08](https://www.youtube.com/watch?v=TfqnaYssa24&t=428) Transition from indie developer Advocate to developer Advocate experience [09:23](https://www.youtube.com/watch?v=TfqnaYssa24&t=563) Writing detailed tutorials requires structure, code examples, testing, and review. [13:39](https://www.youtube.com/watch?v=TfqnaYssa24&t=819) Value of working with amazing people in remote countries [15:39](https://www.youtube.com/watch?v=TfqnaYssa24&t=939) Transitioning from voluntary to paid developer advocacy [19:46](https://www.youtube.com/watch?v=TfqnaYssa24&t=1186) Building credibility through experience and personal branding is key in the tech field. [21:37](https://www.youtube.com/watch?v=TfqnaYssa24&t=1297) Initially hesitant, William Imoh joined Microsoft to champion open source initiatives. [25:20](https://www.youtube.com/watch?v=TfqnaYssa24&t=1520) Started a company with a team of 10 authors who are Engineers first [27:26](https://www.youtube.com/watch?v=TfqnaYssa24&t=1646) DevRelShow helps teams create great documentation for developers. [31:21](https://www.youtube.com/watch?v=TfqnaYssa24&t=1881) Importance of developer-centric documentation [33:18](https://www.youtube.com/watch?v=TfqnaYssa24&t=1998) Technical writing is crucial for Developer Advocates [37:15](https://www.youtube.com/watch?v=TfqnaYssa24&t=2235) The importance of human written content and limitations of AI content. [39:11](https://www.youtube.com/watch?v=TfqnaYssa24&t=2351) The importance of original thinking and creation with AI [43:21](https://www.youtube.com/watch?v=TfqnaYssa24&t=2601) Key points on required skills and best practices for technical writing [45:23](https://www.youtube.com/watch?v=TfqnaYssa24&t=2723) Understanding different developer states when writing style guides. [49:38](https://www.youtube.com/watch?v=TfqnaYssa24&t=2978) Understanding the different types of content at each stage of the funnel [51:45](https://www.youtube.com/watch?v=TfqnaYssa24&t=3105) Regularly update content to remain relevant and useful. [55:42](https://www.youtube.com/watch?v=TfqnaYssa24&t=3342) Sharing expertise and helping others be successful [57:24](https://www.youtube.com/watch?v=TfqnaYssa24&t=3444) Sharing value validates ideas and generates more money [1:01:19](https://www.youtube.com/watch?v=TfqnaYssa24&t=3679) Expressing gratitude towards sponsor Construct and guest William Imoh --------------------------------- Detailed Summary for [devrelshow episode 25 - William Imoh](https://www.youtube.com/watch?v=TfqnaYssa24) by [Merlin](https://merlin.foyer.work/) "devrelshow episode 25 - William Imoh, Founder of Hack M, Discusses Technical Content Creation and Software Engineering" [00:15](https://www.youtube.com/watch?v=TfqnaYssa24&t=15) Introducing William Imoh on the Devo show. - The host discusses his messy background and the excitement of having guests on the show. - William expresses his excitement about being on the show and shares about his life in Oso. [02:38](https://www.youtube.com/watch?v=TfqnaYssa24&t=158) William Imoh is the founder of hack M and helps software teams with technical content. - He leads a team that assists software teams with technical content for developer users. - In addition to work, he enjoys traveling, learning to fly planes, playing basketball, and drinking beer. [07:08](https://www.youtube.com/watch?v=TfqnaYssa24&t=428) Transition from indie developer Advocate to developer Advocate experience - Started by talking about various products and technologies without any affiliation or payment, eventually companies started reaching out to sponsor talks at meetups and conferences. - Focused on writing technical content, peak period of writing around 8 to 10 blog posts a month manually without AI assistance. [09:23](https://www.youtube.com/watch?v=TfqnaYssa24&t=563) Writing detailed tutorials requires structure, code examples, testing, and review. - Include graphics and share code repositories for user access. - Aim for at least 8 high-quality tutorials per month for significant impact. [13:39](https://www.youtube.com/watch?v=TfqnaYssa24&t=819) Value of working with amazing people in remote countries - Emphasizing the importance and value of connecting with and supporting individuals in remote countries for success - Discussion on work-life balance challenges faced in different time zones, particularly in Nigeria [15:39](https://www.youtube.com/watch?v=TfqnaYssa24&t=939) Transitioning from voluntary to paid developer advocacy - -2.1 [19:46](https://www.youtube.com/watch?v=TfqnaYssa24&t=1186) Building credibility through experience and personal branding is key in the tech field. - Participating in activities like giving talks, writing blog posts, and being active in the community can help create social credit. - Creating social credit can lead to opportunities like being approached for job offers based on your expertise and contributions. [21:37](https://www.youtube.com/watch?v=TfqnaYssa24&t=1297) Initially hesitant, William Imoh joined Microsoft to champion open source initiatives. - Microsoft reached out to William multiple times before he accepted the offer. - The job opportunity was to advocate for open source and open data within Microsoft. [25:20](https://www.youtube.com/watch?v=TfqnaYssa24&t=1520) Started a company with a team of 10 authors who are Engineers first - Began part-time in 2021 and transitioned to full-time after two years - Focused on creating original technical content for SAS teams, working with marketing and product teams [27:26](https://www.youtube.com/watch?v=TfqnaYssa24&t=1646) DevRelShow helps teams create great documentation for developers. - DevRelShow restructures documentation, maps the developer journey, and writes content to improve integration times and developer satisfaction. - DevRelShow assists partners in getting more developers, better discovery, and ranking for high value keywords through differentiated and educative SEO content. [31:21](https://www.youtube.com/watch?v=TfqnaYssa24&t=1881) Importance of developer-centric documentation - Developers prioritize understanding the integrating context for seamless integration - Documentation should focus on the developer's needs, not just API specifications [33:18](https://www.youtube.com/watch?v=TfqnaYssa24&t=1998) Technical writing is crucial for Developer Advocates - Documentation is essential even with a technical writers team in the company - AI-generated content may not be effective for technical topics [37:15](https://www.youtube.com/watch?v=TfqnaYssa24&t=2235) The importance of human written content and limitations of AI content. - Storytelling should be easily digestible and genuine, not synthetic or AI-generated. - The company only uses AI as a co-pilot for data analysis and does not rely on it for content creation. [39:11](https://www.youtube.com/watch?v=TfqnaYssa24&t=2351) The importance of original thinking and creation with AI - AI as a co-pilot to improve thinking and creation process - Contribution to technical writing road map for better content creation [43:21](https://www.youtube.com/watch?v=TfqnaYssa24&t=2601) Key points on required skills and best practices for technical writing - Discussion on essential tools and formats for technical writing such as Markdown and SEO tools like SEMrush - Importance of storytelling, engaging readers, crafting titles, handling call to actions, and catering to different user personas [45:23](https://www.youtube.com/watch?v=TfqnaYssa24&t=2723) Understanding different developer states when writing style guides. - Importance of content research in writing technical tutorials. - Different types of technical content: developer documentation, API references, help content. [49:38](https://www.youtube.com/watch?v=TfqnaYssa24&t=2978) Understanding the different types of content at each stage of the funnel - Content at mid-funnel focuses on addressing problems and providing in-depth information without direct sign-up prompts - Content at bottom of the funnel includes tutorials with clear calls-to-action to sign up for specific features or services [51:45](https://www.youtube.com/watch?v=TfqnaYssa24&t=3105) Regularly update content to remain relevant and useful. - Keep an eye on code changes and update content accordingly to prevent outdated information. - Optimize content based on analysis and metrics, such as tracking conversion and monitoring traffic and ranking. [55:42](https://www.youtube.com/watch?v=TfqnaYssa24&t=3342) Sharing expertise and helping others be successful - Encouraging people to share their expertise with others and not worry about competition - Highlighting the commercial benefit of sharing expertise and how it can lead to opportunities [57:24](https://www.youtube.com/watch?v=TfqnaYssa24&t=3444) Sharing value validates ideas and generates more money - Prioritize things that pay at the beginning, but later, give back to the community - Professional technical writing is crucial to ensure proper usage and customer acquisition [1:01:19](https://www.youtube.com/watch?v=TfqnaYssa24&t=3679) Expressing gratitude towards sponsor Construct and guest William Imoh - Construct is mentioned as the sponsor and creator of products like Cube and Colony Cube. - William Imoh is thanked for sharing insights on technical writing and being a guest on the show. <!-- deep-read:sections end --> 📄 **Full text:** ![[Full Document Contents/Articles/Devrelshow Episode 25 - William Imoh|Devrelshow Episode 25 - William Imoh, Frédéric Harper]] ## Highlights - the Devo show uh always excited you know me always happy to do that show uh now you also know the fact that like I still didn't took the time to clean up my background there's still all those wire that look like like I'm I'm I'm not a good Tech person right now if you look at like all those rers behind me not being probably set up but things are working and it's just life being life right now so I'm not ashamed my ([View Highlight](https://read.readwise.io/read/01janpg81p8qyvcx1cqbkgk68g))