Remote Ruby

Diving Into The Deep End of Docs

June 09, 2023 Jason Charnes, Chris Oliver, Andrew Mason Episode 232
Remote Ruby
Diving Into The Deep End of Docs
Show Notes

In this episode, Chris and Andrew have a candid discussion about their programming experiences, the demanding nature of their jobs, and the joy and complexity of coding.  They have a conversation on challenges with dependencies, the new branch settings on GitHub, TypeScript, JavaScript, and the functionality and benefits of using JSDoc. They also dive into the importance of flexibility in code, the evolution of coding practices, their preference for smart editors that provide real time updates, and the topic on the use of AI tools in programming is discussed and whether AI assists or inhibits the developer’s thought process. Also, Andrew tells us about Prefab, a cool Rails tool he recently discovered and found very useful. Hit download to hear more! 

[00:00:35] Andrew tells us he has an app to monitor his activity and sometimes finds himself working for 11 hours straight, and Chris reminisces about the early days of learning to code and the excitement of late night programming. 

[00:04:58] Chris was struggling with dependencies in his work and considers writing his own basic glob functionality. 

[00:11:38] The guys discuss the utility of new branch settings on GitHub, and Andrew tells us he made his own commitlit config and updated his prettier config on his GitHub. 

[00:12:52] They move onto the topic of JavaScript and TypeScript, bringing up JSDoc, and Andrew explains the functionality and benefits of using JSDoc. He shares his discovery that JSDoc can be used to add TypeScript functionality without writing TypeScript, primarily using type comments. 

[00:16:47] Chris notes that this approach allows for middle ground between JavaScript and TypeScript, enhancing editor hints without the complexity of a fully typed language. 

[00:22:50] Chris tells us his journey began in college where he learned multiple languages such as Ruby, Python, C, and Visual Basic. He emphasizes the importance of flexibility in code, allowing it to evolve over time. 

[00:25:18] Andrew shares his dislike for Sorbet and talks about his preference for Solargraph in VS Code, a language server that uses YARD docs for typing.  He’s found this useful in his work, particularly when refactoring. 

[00:27:55] We hear about the greatest code Andrew’s ever written, and Chris and Andrew discuss the use of dynamic languages and how it’s crucial not to lose the essence of languages like Ruby by over-imposing typing. 

[00:33:49] Chris discusses the use of AI tools in programming, such as GitHub’s Copilot, and notes that while they’re useful in generating codes, but they may limit the developer’s thought process since they tend to rely on AI’s suggestion without thinking through the problem. 

[00:37:26] Andrew explains why he showed Chris some documentation he generated from ChatGPT 4, and they both agree that AI-powered tools can make documentation more efficient. 

[00:46:53] Andrew talks about his experience with Product Hunt, and a very useful Rails tool he recently discovered called, which allows developers to target their Rails logs for specific user issues.

[00:53:12] Chris and Andrew discuss the difficulty of dealing with Twitter API and Reddit API pricing, lamenting the high costs for developers. They also talk about their frustrations with companies that acquire and shut down successful third-party apps instead of supporting them.


Chris Oliver

Andrew Mason




Jason Charnes Twitter