Skip to content

Conversation

@sdwheeler
Copy link
Collaborator

@sdwheeler sdwheeler commented May 20, 2021

PR Summary

Fixes AB#1845193 - Fixes #5500 - publish language spec

Select the area of the Table of Contents containing the documents being changed.

Conceptual content

  • Overview and Install
  • Learning PowerShell
    • PowerShell 101
    • Deep dives
    • Remoting
  • Release notes (What's New)
  • Windows PowerShell
    • WMF, ISE, release notes, etc.
  • DSC articles
  • Community resources
  • Sample scripts
  • Gallery articles
  • Scripting and development
    • Language Specification
    • Legacy SDK

Cmdlet reference & about_ topics

  • Preview content
  • Version 7.1 content
  • Version 7.0 content
  • Version 5.1 content

PR Checklist

  • I have read the contributors guide and followed the style and process guidelines
  • PR has a meaningful title
  • PR is targeted at the staging branch
  • All relevant versions updated
  • Includes content related to issues and PRs - see Closing issues using keywords.
  • This PR is ready to merge and is not Work in Progress
    • If the PR is work in progress, please add the prefix WIP: or [WIP] to the beginning of the
      title and remove the prefix when the PR is ready.

@sdwheeler sdwheeler changed the title Fixes #5500 - publish language spec [EIP] Fixes #5500 - publish language spec May 20, 2021
@sdwheeler sdwheeler requested a review from chasewilson May 20, 2021 00:40
@opbld31
Copy link

opbld31 commented May 20, 2021

Docs Build status updates of commit 304480c:

⚠️ Validation status: warnings

File Status Preview URL Details
reference/docs-conceptual/lang-spec/chapter-01.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-02.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-03.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-04.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-05.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-06.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-07.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-08.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-09.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-10.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-11.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-12.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-13.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-14.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-15.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-16.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/learn/ps101/00-introduction.md ⚠️Warning View (>=powershell-5.1) Details
reference/docs-conceptual/toc.yml ✅Succeeded View (>=powershell-5.1)

reference/docs-conceptual/lang-spec/chapter-01.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Warning-duplicate-h1s] H1 'Introduction' is duplicated with other articles: 'docs-conceptual/lang-spec/chapter-01.md, docs-conceptual/learn/ps101/00-introduction.md(8,1)'. First level headings must be unique within a docset.
  • Line 1, Column 1: [Warning-duplicate-titles] Title 'Introduction - PowerShell' is duplicated in: 'docs-conceptual/lang-spec/chapter-01.md, docs-conceptual/learn/ps101/00-introduction.md(2,8)'. Titles must be unique within a docset.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-02.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-03.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-04.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-05.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-06.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-07.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-08.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-09.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-10.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-11.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-12.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-13.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-14.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.
  • Line 343, Column 1: [Suggestion-heading-empty] Empty H3. Headings must have content.

reference/docs-conceptual/lang-spec/chapter-15.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/lang-spec/chapter-16.md

  • Line 1, Column 1: [Warning-title-missing] Missing required attribute: 'title'. Add a title string to show in search engine results.
  • Line 1, Column 1: [Suggestion-description-missing] Missing required attribute: 'description'.

reference/docs-conceptual/learn/ps101/00-introduction.md

  • Line 2, Column 8: [Warning-duplicate-titles] Title 'Introduction - PowerShell' is duplicated in: 'docs-conceptual/lang-spec/chapter-01.md, docs-conceptual/learn/ps101/00-introduction.md(2,8)'. Titles must be unique within a docset.
  • Line 8, Column 1: [Warning-duplicate-h1s] H1 'Introduction' is duplicated with other articles: 'docs-conceptual/lang-spec/chapter-01.md, docs-conceptual/learn/ps101/00-introduction.md(8,1)'. First level headings must be unique within a docset.

For more details, please refer to the build report.

If you see build warnings/errors with permission issues, it might be due to single sign-on (SSO) enabled on Microsoft's GitHub organizations. Please follow instructions here to re-authorize your GitHub account to Docs Build.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

Note: Your PR may contain errors or warnings unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@opbld33
Copy link

opbld33 commented May 20, 2021

Docs Build status updates of commit 1263a66:

✅ Validation status: passed

File Status Preview URL Details
reference/docs-conceptual/lang-spec/chapter-14.md 💡Suggestion View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-01.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-02.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-03.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-04.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-05.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-06.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-07.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-08.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-09.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-10.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-11.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-12.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-13.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-15.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-16.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/toc.yml ✅Succeeded View (>=powershell-5.1)

reference/docs-conceptual/lang-spec/chapter-14.md

  • Line 349, Column 1: [Suggestion-heading-empty] Empty H3. Headings must have content.

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@sdwheeler sdwheeler changed the title [EIP] Fixes #5500 - publish language spec [WIP] Fixes #5500 - publish language spec May 20, 2021
@opbld30
Copy link

opbld30 commented May 20, 2021

Docs Build status updates of commit 3dfc41e:

✅ Validation status: passed

File Status Preview URL Details
reference/docs-conceptual/lang-spec/chapter-14.md 💡Suggestion View (>=powershell-5.1) Details
reference/docs-conceptual/lang-spec/chapter-01.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-02.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-03.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-04.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-05.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-06.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-07.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-08.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-09.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-10.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-11.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-12.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-13.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-15.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-16.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/toc.yml ✅Succeeded View (>=powershell-5.1)

reference/docs-conceptual/lang-spec/chapter-14.md

  • Line 349, Column 1: [Suggestion-heading-empty] Empty H3. Headings must have content.

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@opbld30
Copy link

opbld30 commented May 20, 2021

Docs Build status updates of commit 905659c:

⚠️ Validation status: warnings

File Status Preview URL Details
reference/docs-conceptual/lang-spec/chapter-11.md ⚠️Warning View (>=powershell-5.1) Details
.github/PULL_REQUEST_TEMPLATE.md ✅Succeeded
reference/docfx.json ✅Succeeded
reference/docs-conceptual/lang-spec/chapter-01.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-02.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-03.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-04.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-05.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-06.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-07.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-08.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-09.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-10.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-12.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-13.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-14.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-15.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-16.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/toc.yml ✅Succeeded View (>=powershell-5.1)

reference/docs-conceptual/lang-spec/chapter-11.md

  • Line 145, Column 1: [Warning-invalid-note-section] Text in the first line of Note/Section/Video is not valid. Will be rendered to <blockquote>

For more details, please refer to the build report.

If you see build warnings/errors with permission issues, it might be due to single sign-on (SSO) enabled on Microsoft's GitHub organizations. Please follow instructions here to re-authorize your GitHub account to Docs Build.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

Note: Your PR may contain errors or warnings unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@opbld30
Copy link

opbld30 commented May 20, 2021

Docs Build status updates of commit 8ac3c13:

✅ Validation status: passed

File Status Preview URL Details
.github/PULL_REQUEST_TEMPLATE.md ✅Succeeded
reference/docfx.json ✅Succeeded
reference/docs-conceptual/lang-spec/chapter-01.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-02.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-03.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-04.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-05.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-06.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-07.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-08.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-09.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-10.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-11.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-12.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-13.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-14.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-15.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/lang-spec/chapter-16.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/toc.yml ✅Succeeded View (>=powershell-5.1)

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@sdwheeler sdwheeler merged commit 37a18a3 into MicrosoftDocs:staging May 20, 2021
@sdwheeler sdwheeler changed the title [WIP] Fixes #5500 - publish language spec Fixes #5500 - publish language spec May 20, 2021
@sdwheeler sdwheeler deleted the sdw-i5500 branch May 20, 2021 22:11
Comment on lines +491 to +496
command-parameter:
dash first-parameter-char parameter-chars
colon~opt~ first-parameter-char:
A Unicode character of classes Lu, Ll, Lt, Lm, or Lo
_ (The underscore character U+005F)
?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should colon~opt~ be part of the previous line, and first-parameter-char: aligned to the start of the line?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, thanks for spotting that. Conversion from the Word doc required a lot of cleanup. I am sure I missed many more. More edits to com.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Language specification

5 participants