Search

Bring back some Delimter between Examples in Help by Gary Siepser

Active

4
0
Sign in
to vote
Type: Suggestion
ID: 769337
Opened: 10/31/2012 11:08:51 AM
Access Restriction: Public
0
Workaround(s)
In v1 and v2, there was generous white space and the big "----------"bar between examples when viewing help. I have seen other connect item surrounding the generous white space. Now it seems we might have gone too far in the other direction. There is still white space between the example code and the description text, but there is literally nothing showing between examples themselves. Its really visually difficult to see where an example starts and ends. I don't need the whitespace, but bring back the "-----------" or something. Looking at examples just feels like a chore now. Even when looking at the online versions of help, the code examples are in boxes, but even there, there isn't a whole lot of delimiting between the examples themselves.

See this snippet below from 'get-help new-cimsessoin -examples'.
Can you spot where Example 7,8, and 9 start. Sure, if really focus, but wow, its really hidden in there, especially with the white spaces between code and description.

...
This set of commands gets the CIM instances of a class named Win32_Process and stores them in the variables $x and
$y. The variable $x is then formatted in a table containing only the Name and the KernelModeTime attributes, the
table set to AutoSize.
Example 7: Get CIM instances from remote computer

PS C:\> Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01,Server02


This command retrieves the CIM instances of a class named Win32_ComputerSystem from the remote computers named
Server01 and Server02.
Example 8: Getting only the key properties, instead of all properties

PS C:\> Get-CimInstance -Class Win32_Process -KeyOnly


This command retrieves only the key properties, which reduces the size of the object and network traffic.
Example 9: Getting only a subset of properties, instead of all properties

...
Details (expand)
How often does this happen?
Always Happens
Have you seen this problem before in this product?
No, this is new to the most recent version
Reproduction Steps
View example help section for any cmdlet/function that has multiple examples.
Expected Results
Some sort of delimiter between examples. Maybe (this could be open to majority opinion here) something like this with no new additional white space, but a visual indicator of separation between examples that would likely not exist in text in someone's help.

...
This set of commands gets the CIM instances of a class named Win32_Process and stores them in the variables $x and
$y. The variable $x is then formatted in a table containing only the Name and the KernelModeTime attributes, the
table set to AutoSize.
--------------------------------------------------------------------------------------------
Example 7: Get CIM instances from remote computer

PS C:\> Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01,Server02


This command retrieves the CIM instances of a class named Win32_ComputerSystem from the remote computers named
Server01 and Server02.
--------------------------------------------------------------------------------------------
Example 8: Getting only the key properties, instead of all properties

PS C:\> Get-CimInstance -Class Win32_Process -KeyOnly


This command retrieves only the key properties, which reduces the size of the object and network traffic.
--------------------------------------------------------------------------------------------
Example 9: Getting only a subset of properties, instead of all properties
...
File Attachments
0 attachments
Sign in to post a comment.
Sign in to post a workaround.