Help Us Improve our Ebooks – Your Chance to Contribute!
We recently re-launched all of our free ebooks at https://leanpub.com/u/devopscollective. These books have all been authored by a variety of people, myself included, and most were originally authors in Word. As we translated them into Markdown (which is what Leanpub uses for its source), a few snafus tend to come up here and there.
Note that these books create no profit for anyone: all authors donated them to The DevOps Collective. When someone chooses to pay for an ebook during checkout (they’re priced at $0.00, but you can pay anything you like), those funds go to help The DevOps Collective’s programs, including our operational costs, OnRamp Scholarship, and more. So the books are entirely a volunteer effort, owned and maintained by the community at large.
For example, in the table of contents for https://leanpub.com/thebigbookofpowershellgotchas/read, you’ll see a lot of “I”™" type nonsense, which typically comes from Word’s “smart quotes” feature when those get translated into plain ASCII. You’ll also find the odd formatting issue, like backslashes at the end of code lines, which are meant to represent line breaks, or missing backslashes in paths, because backslashes need to be doubled in order to prevent them from being seen as an escape character.
Anyway - they’re all minor snafus, but it’s difficult for me to carve off time to go through all the books and fix every little one.
Which is where you can help!
These books are all open source, and hosted at https://github.com/devops-collective-inc. Anyone can use GitHub to clone the book repo, make whatever changes they want, commit those changes to their local repo, and then submit a pull request back to the main online repo. I review those PRs weekly.
So this is a great chance for you to contribute to the community. If these ebooks have ever helped you, then you can “give back” a bit by helping us fine-tune them.
And here’s a tip: if you make a change, please also clone the Spanish version of the ebook and make the same change. That way we can keep the Spanish versions updated as well. Thanks again to community contributor Alvaro Tatis Torres for creating those Spanish versions entirely on his own time!
You’re also welcome to make more substantive contributions. For example, Secrets of PowerShell Remoting could use a chapter on setting up Remoting-over-SSH for both Windows and Linux/macOS. Once more folks start contributing, I’ll be updating the credits on the book to reflect the broader, community-based authorship of each.
Please help spread the word - even if you can’t carve off the time to help, maybe someone you know could proofread a chapter or two. Scanning the online reader or the PDF version will reveal most of the oddities, and you can then dive into the source on GitHub to make corrections.
THANK YOU!
Related Articles
PowerShell Escape Room
PowerShell Escape Room by Michiel Hamers by Michiel Hamers https://about.me/michielhamers/ Why on earth you want to create an Escape Room with PowerShell as backend? I’ve always been a fan of escape rooms, so I decided to create my own for my kids. I wanted to make it something that would be challenging and fun for them, but also educational. I decided to use PowerShell as the backend for the escape room, as I’m a PowerShell developer and I thought it would be a great way to learn more about the language.
Microsoft Graph PowerShell Module: Getting Started Guide
Microsoft Graph PowerShell Module: Getting Started Guide by Jeff Brown Microsoft is retiring the Azure AD Graph API sometime after June 30, 2023 (announcement). This retirement includes the Azure AD PowerShell module. In its place, Microsoft has released the Microsoft Graph PowerShell module. The Microsoft Graph PowerShell module is the next-generation way of managing Microsoft cloud services using PowerShell. If you have used MSOnline or Azure AD PowerShell in the past, you’ll need to read on to learn about this new module.
ICYMI: PowerShell Week of 08-October-2021
Topics include VMWare, Windows 11, Web Reports and more… Special thanks to Robin Dadswell, Prasoon Karunan V, Kiran Patnayakuni and Kevin Laux How to gather your vCenter inventory data with this VMware PowerShell script by Scott Matteson on 7th October Inventory reports are a common request when administering a VMware vCenter environment. Learn how this VMware PowerShell script can make such requests quick and easy Building a Web Report in PowerShell, use the -Force Luke by Chris Noring on 8th October