https://blog.isquaredsoftware.com/tags/docs/index.xml Recent content on Mark's Dev Blog Hugo -- gohugo.io https://blog.isquaredsoftware.com/2024/11/presentations-maintaining-community/ Thu, 21 Nov 2024 21:00:00 -0500 https://blog.isquaredsoftware.com/2024/11/presentations-maintaining-community/ <p></p> <p>The main thesis of this talk is that maintainers do a <em>lot</em> more than just write features and fix bugs, and that really most of what we do involves thinking about and interacting with the users of our library. That includes answering support questions, writing docs, thinking about how versioning and backwards compatibility will impact people, and a lot more.</p> <p>Hopefully this proves useful to other maintainers, and peels back the curtain on what it's like to maintain a widely-used library.</p> <h2 id="react-summit-us-2024">React Summit US 2024</h2> <p>I first did this talk at React Summit US in November 2024:</p> <h3 id="maintaining-a-library-and-a-community-video-https-gitnation-com-contents-maintaining-a-library-and-a-community"><a href="https://gitnation.com/contents/maintaining-a-library-and-a-community">Maintaining a Library and a Community - video</a></h3> <p>And here's the slides:</p> <h3 id="maintaining-a-library-and-a-community-slides-presentations-2024-11-maintaining-community"><a href="https://blog.isquaredsoftware.com/presentations/2024-11-maintaining-community/">Maintaining a Library and a Community - slides</a></h3> <p>I also got to participate in a panel discussion on &quot;The Future of React&quot;, with members of the React team and the community. This was a pretty good discussion:</p> <h3 id="the-future-of-react-panel-video-https-gitnation-com-contents-panel-discussion-future-of-react"><a href="https://gitnation.com/contents/panel-discussion-future-of-react">The Future of React panel - video</a></h3> <h2 id="ndc-oslo-2025">NDC Oslo 2025</h2> <p>For NDC Oslo, I significantly expanded and updated the content and slides. Part of that is that I had an entire hour time slot instead of just 20 minutes, but also I thought of a lot more things to say :)</p> <h3 id="maintaining-a-library-and-a-community-slides-presentations-2025-05-maintaining-community"><a href="https://blog.isquaredsoftware.com/presentations/2025-05-maintaining-community/">Maintaining a Library and a Community - slides</a></h3> <p>Video should be available online about a month after the conference, and I'll update this post once it's available.</p> <p><a href="https://www.youtube.com/live/42kUqbV3wIc?si=asXlCveJ_o660adX">https://www.youtube.com/live/42kUqbV3wIc?si=asXlCveJ_o660adX</a></p> https://blog.isquaredsoftware.com/2024/11/presentations-designing-documentation/ Thu, 21 Nov 2024 20:00:00 -0500 https://blog.isquaredsoftware.com/2024/11/presentations-designing-documentation/ <p></p> <p>My remote presentation for React Advanced 2024 was on &quot;Designing Effective Documentation: Lessons Learned Writing the Redux Docs&quot;.</p> <p>I've spent a <em>lot</em> of my time working on the Redux docs, and it is in fact <a href="https://blog.isquaredsoftware.com/2016/09/how-i-got-here-my-journey-into-the-world-of-redux-and-open-source/">how I got my start working on Redux!</a>.</p> <p>Hopefully this proves useful to other folks writing docs for tools and libraries.</p> <h3 id="designing-effective-documentation-video-https-gitnation-com-contents-designing-effective-documentation-lessons-learned-building-the-redux-docs"><a href="https://gitnation.com/contents/designing-effective-documentation-lessons-learned-building-the-redux-docs">Designing Effective Documentation - video</a></h3> <p>And here's the slides:</p> <h3 id="designing-effective-documentation-slides-presentations-2024-10-designing-documentation"><a href="https://blog.isquaredsoftware.com/presentations/2024-10-designing-documentation/">Designing Effective Documentation - slides</a></h3>