https://www.sh-soft.de/tags/documentation/ Recent content in Documentation on Steffen Hoppe – Infrastructure Reality & Insight Hugo en Fri, 02 Jan 2026 00:00:00 +0000 https://www.sh-soft.de/posts/powershell/creating-powershell-modules/ Thu, 19 Jun 2025 00:00:00 +0000 https://www.sh-soft.de/posts/powershell/creating-powershell-modules/ PowerShell modules provide a clean, powerful way to package, share, and maintain automation code. Instead of scattered scripts, modules help you organize your functions, enforce consistency, and deliver reliable tools to colleagues, teams, or external users. Why write modules? 📦 Reusability: Group related functions together for easy reuse across projects. ⚙ Maintainability: Simplify updates, debugging, and version control. 🤝 Collaboration: Provide a clear API surface for team members or customers. 🚀 Distribution: Make your code installable via PowerShell Gallery, NuGet feeds, or internal repositories. https://www.sh-soft.de/pings/014-documentation-usefulness/ Fri, 02 Jan 2026 00:00:00 +0000 https://www.sh-soft.de/pings/014-documentation-usefulness/ Documentation becomes effective when it is written by the people who do the work, for the people who do the work. It helps with repeatability, clarity and avoiding mistakes. But this value rarely scales. Local documentation reflects reality. Organizational documentation reflects narrative. https://www.sh-soft.de/pings/011-documentation-creates-illusion-of-control/ Tue, 23 Dec 2025 00:00:00 +0000 https://www.sh-soft.de/pings/011-documentation-creates-illusion-of-control/ Many teams produce documentation to satisfy organizational expectations — to show that systems are structured, understandable and under control. But if documentation truly reflected reality, people would say: “Read the documentation first.” They rarely do. Instead, they tell you who to ask. Documentation often describes how systems should be, not how they actually work.