I build and fix mobile apps for people. Polyglot programmer, climber, photographer, capoeirista. Brains & Beards. XR Tech.
Name pronunciation: boy-tech or [ voi - tek ]
A new episode of BBS (my podcast) is out 🎉
Together with @patryk we discuss different types of documentation that you might come across (or should consider 💡) in a React Native codebase. Tune in at you favourite podcast provider 📻
(Or here: https://podcast.brainsandbeards.com/episodes/bbs-19-documentation-in-software-projects-BfAtxvXU )
The podcast discusses various types of documentation for software projects, including documenting code and external documentation. It explores what should be documented within code comments versus other approaches like TypeScript. Maintaining outdated documentation is an issue, so validation through tests or expected errors is preferable. External documentation like readmes should link to other sources rather than include details likely to become outdated. Architectural decision records are recommended to explain important design choices. The discussion also covers establishing a domain language to reduce ambiguity and standardizing terminology between teams. Overall, the podcast emphasizes writing documentation that remains useful over time rather than just explaining code.
When you work full-time with a single framework you get used to "standard" ways of doing things (fastlane, eslint, prettier, etc.) and you might feel that writing docs is not really necessary.
However, I wanted to share an approach to documentation that I find particularly useful: https://brainsandbeards.com/blog/2023-useful-documentation-adrs
In this episode, we will explore what Patryk and Wojciech have on their desk for fun and profit. And maybe they will even lift the veil of secrecy of what is hiding under their desks 😱 Socking news!
Looks like we're getting back into the flow with the podcast. The newest episode is a longer conversation about my Maintainable React Native course: https://podcast.brainsandbeards.com/episodes/bbs-16-maintainable-react-native-course
What it is, who it is for, and where to find it. The last part is easy: https://brainsandbeards.com/mrn
In this episode Wojciech will tell us about a new course he is preparing for us all. It’s called Maintainable React Native. Enjoy!
We've just dropped a new podcast episode on the benefits you can get out of React Native's separation of meaningful code into the JS bundle: https://podcast.brainsandbeards.com/episodes/bbs-15-juggling-js-bundles
Make this implementation detail work for you 💪
In this episode, we're talking about different ways you can distribute test builds of your app to other members of your team, from very simple setups to elaborate workflows for product teams in larger organizations.
I've recorded a short intro to what Option / Maybe types are (for uninitiated), so that I can avoid explaining it manually again in the future: https://www.youtube.com/watch?v=OabsDW4a-Ik
Feel free to use it as well :)
Chris Martin