Rewrote code examples #4014

YuriySamorodov · 2019-03-18T20:10:55Z

Rewrote code examples. Many of those did not work at all like New-PSSessionConfigurationFile. And many did not look good.

Version(s) of document impacted

Reason(s) for not updating all version of documents

The documented feature was introduced in version (list version here) of PowerShell
This issue only shows up in version (list version(s) here) of the document
This PR partially fixes the issue, and issue # tracks the remaining work

Rewrote code examples. Many of those did not work at all like New-PSSessionConfigurationFile. And many did not look good.

zjalexander · 2019-03-18T20:14:29Z

OPS Build status updates of commit 4f6bbbd:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :66:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

git markup fix attempt

zjalexander · 2019-03-18T20:24:29Z

OPS Build status updates of commit fd25170:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :69:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt #2

zjalexander · 2019-03-18T20:33:25Z

OPS Build status updates of commit 2032d1b:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :69:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 3

zjalexander · 2019-03-18T20:39:40Z

OPS Build status updates of commit 95d54f9:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :69:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 4

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

zjalexander · 2019-03-18T20:44:56Z

OPS Build status updates of commit eab0345:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :70:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 5

zjalexander · 2019-03-18T20:54:00Z

OPS Build status updates of commit 8e3f91e:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :70:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 6

zjalexander · 2019-03-19T10:18:25Z

OPS Build status updates of commit 0137079:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :73:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 7

zjalexander · 2019-03-19T10:24:15Z

OPS Build status updates of commit 9111818:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :72:(1301) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

zjalexander · 2019-03-19T10:43:45Z

OPS Build status updates of commit 12893cc:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :72:(1301) '```
Register-PSSessionConfiguration -Path .\NoLan...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 9

YuriySamorodov

markup fix attempt 9

zjalexander · 2019-03-19T12:42:24Z

OPS Build status updates of commit 8df2b4a:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :60:(1037) '#### Creating resticted sessions with files

'
Expect Heading level 3

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

sdwheeler · 2019-03-19T15:07:08Z

@YuriySamorodov There is no way to accomplish the formatting you are trying to do. See:
https://github.com/MicrosoftDocs/PowerShell-Docs/blob/staging/contributing/6-UPDATING-REFERENCE.md#writing-examples

This is a limitation of PlatyPS.

The schema does not allow code blocks to be separated by paragraphs in an example. The valid schema is:

### Example #X title
0 or more paragraphs
1 or more code blocks
0 or more paragraphs.

YuriySamorodov

markup fix attempt 10

zjalexander · 2019-03-19T15:35:49Z

OPS Build status updates of commit 3dd86c7:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :60:(1037) '###

'
Unexpected header name #

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov · 2019-03-19T15:36:56Z

@sdwheeler Thank you very much for taking your time explaining me that. Did not realize what the limitations were until I looked into Powershell-Docs-CI console.
Currently I am in the middle of trying to find out what we can do in this case. Problem is that code blocks do not have auto wrapping and comments will not get to the new line until line break or caret return symbol. I just want examples be more readable....
Thank you for your patience and sorry for the errors

YuriySamorodov

markup fix attempt 11

zjalexander · 2019-03-19T15:42:07Z

OPS Build status updates of commit 352ca68:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :60:(1037) '###

'
Unexpected header name #

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 11

zjalexander · 2019-03-19T15:52:52Z

OPS Build status updates of commit fc1e7f7:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :130:(1748) '```powershell
Set-PSSessionConfiguration -Name IT...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 12

zjalexander · 2019-03-19T16:16:37Z

OPS Build status updates of commit 922dbde:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :168:(2628) '```powershell
Test-PSSessionConfigurationFile -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

YuriySamorodov

markup fix attempt 13

zjalexander · 2019-03-19T16:23:49Z

OPS Build status updates of commit a14924c:

✅ Validation status: passed

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	✅Succeeded	View (powershell-6)

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

Replaced fake sections with the list items

YuriySamorodov

Replaced fake sections with the bullet list items

zjalexander · 2019-03-19T18:13:03Z

OPS Build status updates of commit 4cea5a8:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :69:(1303) '```powershell
Register-PSSessionConfiguration -Pa...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

Rolled back the changes to the state of markup fix attempt 13

YuriySamorodov

Rolled back the changes to the state of markup fix attempt 13

zjalexander · 2019-03-19T18:35:45Z

OPS Build status updates of commit 028a5fc:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	❌Error		Details

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md

[Error] Unable to load file '6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md' via processor 'AzureCliDocumentProcessor': :162:(2455) '```powershell
AliasDefinitions = @(@{Name='slst';...'
Expect Heading

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

Formatted alias reference with Italics

YuriySamorodov

Formatted alias reference with Italics

zjalexander · 2019-03-19T18:44:10Z

OPS Build status updates of commit 0dfc4b4:

✅ Validation status: passed

File	Status	Preview URL	Details
reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md	✅Succeeded	View (powershell-6)

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

sdwheeler · 2019-03-21T15:48:14Z

@YuriySamorodov I appreciate your efforts but there are several issues with this article and we cannot accept the hack you found to get around the PlatyPS limitations. I have edited the article and fixed the issues. See #4024

Rewrote code examples

4f6bbbd

Rewrote code examples. Many of those did not work at all like New-PSSessionConfigurationFile. And many did not look good.

Git Markup fix attempt

fd25170

YuriySamorodov commented Mar 18, 2019

View reviewed changes

markup fix attempt MicrosoftDocs#2

2032d1b

YuriySamorodov commented Mar 18, 2019

View reviewed changes

markup fix attempt MicrosoftDocs#3

95d54f9

YuriySamorodov commented Mar 18, 2019

View reviewed changes

markup fix attempt 4

eab0345

YuriySamorodov commented Mar 18, 2019

View reviewed changes

sdwheeler requested changes Mar 18, 2019

View reviewed changes

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md Outdated Show resolved Hide resolved

reference/6/Microsoft.PowerShell.Core/New-PSSessionConfigurationFile.md Show resolved Hide resolved

markup fix attempt 5

8e3f91e

YuriySamorodov commented Mar 18, 2019

View reviewed changes

markup fix attempt 6

0137079

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix attempt 7

9111818

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix attempt 8

12893cc

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix attempt 9

8df2b4a

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix 10

3dd86c7

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix attempt 11

352ca68

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix attempt 11

fc1e7f7

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix attempt 12

922dbde

YuriySamorodov commented Mar 19, 2019

View reviewed changes

markup fix attempt 13

a14924c

YuriySamorodov commented Mar 19, 2019

View reviewed changes

Replaced fake sections with the list

4cea5a8

Replaced fake sections with the list items

YuriySamorodov commented Mar 19, 2019

View reviewed changes

Rolled back the last change

028a5fc

Rolled back the changes to the state of markup fix attempt 13

YuriySamorodov commented Mar 19, 2019

View reviewed changes

Formatted alias reference with Italics

0dfc4b4

Formatted alias reference with Italics

YuriySamorodov commented Mar 19, 2019

View reviewed changes

sdwheeler closed this Mar 21, 2019

sdwheeler added the do-not-merge Tag - closed without merging label Mar 21, 2019

Rewrote code examples #4014

Rewrote code examples #4014

Uh oh!

Conversation

YuriySamorodov commented Mar 18, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Version(s) of document impacted

Reason(s) for not updating all version of documents

Uh oh!

zjalexander commented Mar 18, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 18, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 18, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 18, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

zjalexander commented Mar 18, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 18, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 19, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 19, 2019

❌ Validation status: errors

Uh oh!

zjalexander commented Mar 19, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 19, 2019

❌ Validation status: errors

Uh oh!

sdwheeler commented Mar 19, 2019

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

Uh oh!

zjalexander commented Mar 19, 2019

❌ Validation status: errors

Uh oh!

YuriySamorodov commented Mar 19, 2019

Uh oh!

YuriySamorodov left a comment

Choose a reason for hiding this comment

YuriySamorodov commented Mar 18, 2019 •

edited

Loading