devblackops / building-powershell-modules-feedback

Feedback on the PowerShell Module Development book
6 stars 1 forks source link

General feedback: #28

Open Dev-Larks opened 4 years ago

Dev-Larks commented 4 years ago

Description

Hey Brandon

I was reading Ch10 today, and one thing that I thought might be worthwhile providing feedback on is the utilisation of a visual indicator of changes insertions/deletions in the scripts you are showing. In other books that I have the Learn PS in a Month of Lunches for example new lines of code are shown in bold font (admittedly in these books the code listing is all in black and white).

For lines that have been moved strikingthrough the redundant code could be an option?

Hopefully some useful feedback to consider, today I resorted to going through the code line by line to identify what had changed. Looking forward to reading Ch11 when it drops.

Hope you and your family are keeping well - Craig

devblackops commented 4 years ago

That's good feedback @Dev-Larks. I know that Markua supports a way of marking added/deleted code by bolding or striking out text. I'll have to play with that. I agree, it makes it easier to identify what's changed.

https://leanpub.com/markua/read#code