Tag: writing

The Missing Pieces: What Online Tutorials and Docs Always Seem to Forget

The post addresses common shortcomings in online tutorials and documentation. It emphasizes the importance of clear prerequisites, context, real-world use cases, error handling, performance, security, integration, testing strategies, and attention to detail. The author urges tutorial creators to eliminate assumptions and provide comprehensive guidance for users of all skill levels. Continue reading →

My Review of JetBrains’ Writerside ✅ or ❎ ?

JetBrains’ latest innovation, Writerside, is revolutionizing the technical writing landscape. This tool, developed on the IntelliJ platform, seamlessly blends the worlds of coding and prose. It supports both Markdown and a custom XML-based markup, features over 100 built-in tests, pre-configured designs, and an AI-driven spellchecker and grammar tool. Additionally, it promotes collaboration with its “doc... Continue reading →

Oh the coding stories…

I’ve finally started writing steadily again, after stumbling through more than a few stages of writer’s block. The most recent escapades started with “Quick Start Connections with Terraform and Kubernetes” and “State for Terraform with Google Cloud Storage (GCS)”. But really, there are several types of articles I really need to kick into gear again.... Continue reading →

Back From Scandinavia, Back to Project Coding, Writing and Organizing

I just got back from Scandinavia (and Amsterdam). I went for a million reasons, mostly for the adventure of it. Visiting Stockholm, Copenhagen and Reykjavik I saw about a zillion bikes, great architecture, Tivoli, amazing and beautiful waterways, Viking boat building museums, design to die for and so much more. It’s truly one of the... Continue reading →