mato (44) [Avatar] Offline
#1
If you subscribed to the MEAP for this book, you have early access to the book's chapters. In fact, you have access to the chapters before our copy editors! You will undoubtedly find typos and grammatical errors that will be corrected by the copy editors before the manuscript is final. To avoid clutter in the forum, please post any reports of typos and grammatical errors in this thread only.
Andrew Tearle (12) [Avatar] Offline
#2
Re: Please report typos and grammatical errors in this thread only!
PowerShell and WMI - Richard Siddaway

--------------------------------------------------------------------------------------------------

121 The full article is available from the PowerShell Team blog at http://blogs.msdn.com/b/powershell/.
A search for “sematic gap” will take you to the post. (Semantic Gap)

Pg 14 this is a warning that I will be repeated periodically throughout the book (Repeating)

--------------------------------------------------------------------------------------------------
richard.siddaway (42) [Avatar] Offline
#3
Re: Please report typos and grammatical errors in this thread only!
Thank you Andrew.

Duly noted and filed for updating
Makovec (72) [Avatar] Offline
#4
Re: Please report typos and grammatical errors in this thread only!
One general note. In chapter 5 you started to mentioned one technique per chapter. To me this format:

Technique 1 Get computer system information

is less clear than (suggestion to add colon)

Technique 1: Get computer system information

Also note to tables. As it not contains horizontal rules it's not obvious which cmdlet belongs to component (table 5..2, but is valid for most of the tables)

Function names are not consistent across this chapter. Sometimes all lowercase (get-input), sometimes verb lower and noun correctly (get-BootConfig) but never "correctly" (Test-SystemTime).

I also found a lot of typographical errors (bad typeface) but assume someone will check it. For me the most problematic now is BIOS mentioned in ch 5.1.5

Message was edited by:
Makovec
-- added note to function names
Makovec (72) [Avatar] Offline
#5
Re: Please report typos and grammatical errors in this thread only!
Listing 5.2

in $fam, #131 - Famiily (double i)
I see that the same typo is at MSDN which you used as source.

in $type - empty line between #4 and #6 (or missing #5)
Makovec (72) [Avatar] Offline
#6
Re: Please report typos and grammatical errors in this thread only!
Listing 5.9

Name of function doesn't follow verb-noun convention. get-ports vs. get-port.
Makovec (72) [Avatar] Offline
#7
Re: Please report typos and grammatical errors in this thread only!
Listing 5.12

current: "System on Mains Power"
should be: "System on Main Power"
Makovec (72) [Avatar] Offline
#8
Re: Please report typos and grammatical errors in this thread only!
Listing 5.13

In second call of Win32_PowerPlan class (active plan details) you are missing -ComputerName parameter.

My personal thoughts: You are calling Win32_PowerPlan twice (at the beginning, not talking about query in #3 and below). First time you just display some info and second time you filter active plan. Personally (just my opinion) I'd rather call it once at the beginning, store it to variable and then format/filter this variable.
Makovec (72) [Avatar] Offline
#9
Re: Please report typos and grammatical errors in this thread only!
Page 158:
Current: kilobyes
Corrected: kilobytes

Page 160:
Current: boot configuration must be checked to on systems to ensure
Should be: boot configuration must be checked on systems to ensure
richard.siddaway (42) [Avatar] Offline
#10
Re: Please report typos and grammatical errors in this thread only!
Hi Makovec

Thanks for the coments. I'll answer them individually.

I haven't seen the final layout but I am expecting somehting similar to the PowerShell in Practice layout where there was an icon that incorporated the "Technique XX" part. This provided the separation and clarity you mention. Examples can be seen in chapters 5 and 6 of PowerShell in Practice which can be downloaded from http://www.manning.com/siddaway/

Not sure what we can do with table 5.2 etc. I'll try and re-think the table layout

Function names will be mainly all lower case throughout the book. I prefer my functions that way to seperate them from cmdlets. The cmdlet capitalization style is not mandatory so cannot be labelled as "correct". Some functions such as get-BootConfig just seemd to read better with some capitalisation.

I think you comments regarding the type face are in regard to where it changes for code, cmdlet names, parameters etc. This is deliberate and follows Manning practice.
richard.siddaway (42) [Avatar] Offline
#11
Re: Please report typos and grammatical errors in this thread only!
Your comment about listing 5.2 - I think you mean listing 5.4

The ii in family was copied from MSDN - oops. I've corrected it

and removed the blank line
richard.siddaway (42) [Avatar] Offline
#12
Re: Please report typos and grammatical errors in this thread only!
listing 5.9 - agreed that nouns should be singular. I've made the change
richard.siddaway (42) [Avatar] Offline
#13
Re: Please report typos and grammatical errors in this thread only!
In England it is always referred to Mains Power.

I'll check with the editor
richard.siddaway (42) [Avatar] Offline
#14
Re: Please report typos and grammatical errors in this thread only!
Agreed about computername missing & fixed it

I use the technique of saving to variable and using it that way in a number of other scripts in the book. I want to try and show as many different ways of working as possible so that people learn how flexible PowerShell is
richard.siddaway (42) [Avatar] Offline
#15
Re: Please report typos and grammatical errors in this thread only!
Hi

checked both of these and corrected.
richard.siddaway (42) [Avatar] Offline
#16
Re: Please report typos and grammatical errors in this thread only!
Hi Makovec

Thank you for reading the MEAP and especially thank you for taking the time to post the typos you spotted.

I've fixed most of them in the manuscript and will check with the editor about the others.
saleyoung (2) [Avatar] Offline
#17
Re: Please report typos and grammatical errors in this thread only!
Last paragraph on page 3 lacks consistency with "he" or "we" but not both.

"He has 100 servers to administer before virtualization. If we use four physical hosts and virtualize our 100 server he now has 104 servers to administer."

"We have 100 servers to administer before virtualization. If we use four physical hosts and virtualize our 100 servers, we now have 104 servers to administer."
or
"He has 100 servers to administer before virtualization. If he uses four physical hosts and virtualize 100 servers, he now has 104 servers to administer."
price.joshua.j@gmail.com (1) [Avatar] Offline
#18
Re: Please report typos and grammatical errors in this thread only!
pg 16 Distributed Management Task Force or DTMF

i believe is meant to be DMTF
richard.siddaway (42) [Avatar] Offline
#19
Re: Please report typos and grammatical errors in this thread only!
Got it - thanks for posting
alone (1) [Avatar] Offline
#20
Re: Please report typos and grammatical errors in this thread only!
Thanks for the book.
There seems to be a mistake in listing 6.11. There drive to FORMAT will always be D:. The parameter passed to the function is not taken into consideration.