Deal of the Day

Home » Main » Manning Forums » 2010 » PowerShell and WMI

Thread: Please report typos and grammatical errors in this thread only!

Reply to this Thread Reply to this Thread Search Forum Search Forum Back to Thread List Back to Thread List

Permlink Replies: 19 - Pages: 2 [ 1 2 | Next ] - Last Post: Nov 4, 2012 11:03 PM by: alone Threads: [ Previous | Next ]
mato

Posts: 44
Registered: 3/31/10
Please report typos and grammatical errors in this thread only!
Posted: Nov 15, 2010 11:15 AM
  Click to reply to this thread Reply

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


Posts: 12
From: Maungakaramea
Registered: 8/21/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Dec 14, 2010 8:09 PM   in response to: mato in response to: mato
  Click to reply to this thread Reply

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

Posts: 42
Registered: 8/18/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Dec 24, 2010 7:21 AM   in response to: Andrew Tearle in response to: Andrew Tearle
  Click to reply to this thread Reply

Thank you Andrew.

Duly noted and filed for updating

Makovec

Posts: 72
From: Czech Republic
Registered: 2/20/09
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 3, 2011 1:41 PM   in response to: mato in response to: mato
  Click to reply to this thread Reply

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

Posts: 72
From: Czech Republic
Registered: 2/20/09
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 3, 2011 2:03 PM   in response to: mato in response to: mato
  Click to reply to this thread Reply

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

Posts: 72
From: Czech Republic
Registered: 2/20/09
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 3, 2011 2:07 PM   in response to: mato in response to: mato
  Click to reply to this thread Reply

Listing 5.9

Name of function doesn't follow verb-noun convention. get-ports vs. get-port.

Makovec

Posts: 72
From: Czech Republic
Registered: 2/20/09
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 3, 2011 2:27 PM   in response to: mato in response to: mato
  Click to reply to this thread Reply

Listing 5.12

current: "System on Mains Power"
should be: "System on Main Power"

Makovec

Posts: 72
From: Czech Republic
Registered: 2/20/09
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 3, 2011 2:35 PM   in response to: mato in response to: mato
  Click to reply to this thread Reply

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

Posts: 72
From: Czech Republic
Registered: 2/20/09
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 3, 2011 2:39 PM   in response to: mato in response to: mato
  Click to reply to this thread Reply

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

Posts: 42
Registered: 8/18/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 6, 2011 3:33 PM   in response to: Makovec in response to: Makovec
  Click to reply to this thread Reply

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

Posts: 42
Registered: 8/18/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 6, 2011 3:44 PM   in response to: Makovec in response to: Makovec
  Click to reply to this thread Reply

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

Posts: 42
Registered: 8/18/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 6, 2011 3:48 PM   in response to: Makovec in response to: Makovec
  Click to reply to this thread Reply

listing 5.9 - agreed that nouns should be singular. I've made the change

richard.siddaway

Posts: 42
Registered: 8/18/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 6, 2011 3:49 PM   in response to: Makovec in response to: Makovec
  Click to reply to this thread Reply

In England it is always referred to Mains Power.

I'll check with the editor

richard.siddaway

Posts: 42
Registered: 8/18/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 6, 2011 3:53 PM   in response to: Makovec in response to: Makovec
  Click to reply to this thread Reply

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

Posts: 42
Registered: 8/18/08
Re: Please report typos and grammatical errors in this thread only!
Posted: Mar 6, 2011 3:58 PM   in response to: Makovec in response to: Makovec
  Click to reply to this thread Reply

Hi

checked both of these and corrected.

Legend
Gold: 300 + pts
Silver: 100 - 299 pts
Bronze: 25 - 99 pts
Manning Author
Manning Staff
Manning Developmental Editor