Skip to content

Commit

Permalink
Update monthly community pages (MicrosoftDocs#5857)
Browse files Browse the repository at this point in the history
  • Loading branch information
sdwheeler authored May 1, 2020
1 parent 4bda108 commit cdb089a
Show file tree
Hide file tree
Showing 8 changed files with 215 additions and 67 deletions.
5 changes: 5 additions & 0 deletions .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@
"redirect_url": "https://docs.microsoft.com/powershell/scripting/overview",
"redirect_document_id": false
},
{
"source_path": "reference/docs-conceptual/community/whats-new-in-docs.md",
"redirect_url": "https://docs.microsoft.com/powershell/scripting/community/community-update",
"redirect_document_id": false
},
{
"source_path": "reference/docs-conceptual/developer/index.md",
"redirect_url": "https://docs.microsoft.com/powershell/scripting/developer/windows-powershell",
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: What's New in PowerShell Docs
title: What's New in PowerShell Docs for 2020-Q1
description: List of changes to the PowerShell documentation
ms.date: 03/31/2020
---
Expand Down Expand Up @@ -105,52 +105,5 @@ issues. Thank you!
- VLoub - 2 issues
- doctordns - 2 issues

## Community Contributor Hall of Fame

The PowerShell Community is a vibrant and collaborative group. We greatly appreciate all the help
and support we get from the community. Learn how you can contribute by reading the
[Contributor's Guide][contrib].

As of March 1, 2020, these GitHub users are the All-Time Top Community Contributors.

### Pull Requests opened

Pull Requests help us fix those issues and make the documentation better for everyone.

| Docs PRs Submitted | 2016 | 2017 | 2018 | 2019 | 2020 | Grand Total |
| ------------------ | ---: | ---: | ---: | ---: | ---: | ----------: |
| Community Total | 198 | 448 | 468 | 322 | 22 | 1469 |
| matt9ucci | | 157 | 80 | 30 | | 267 |
| nschonni | | | 14 | 138 | | 152 |
| kiazhi | 25 | 79 | 12 | | | 116 |
| alexandair | 59 | 8 | 26 | 2 | | 95 |
| doctordns | 5 | 32 | 20 | 7 | 2 | 66 |
| sethvs | | 1 | 44 | | | 45 |
| Dan1el42 | 20 | | | | | 20 |
| NReilingh | 2 | | 13 | 3 | | 18 |
| it-praktyk | | | 16 | 1 | | 17 |
| markekraus | | 11 | 5 | | | 16 |
| purdo17 | | | 13 | | | 13 |
| k-takai | | | 5 | 1 | 7 | 13 |
| kvprasoon | 2 | 1 | 7 | 2 | | 12 |
| PlagueHO | 10 | | | 1 | | 11 |
| KirkMunro | 1 | 1 | 2 | 6 | | 10 |
| exchange12rocks | | 7 | 3 | | | 10 |

### GitHub issues opened

GitHub issues help us identify errors and gaps in our documentation.

| Docs Issues opened | 2016 | 2017 | 2018 | 2019 | 2020 | Grand Total |
| ------------------ | ---: | ---: | ---: | ---: | ---: | ----------: |
| Community Total | 34 | 95 | 213 | 575 | 123 | 1081 |
| mklement0 | | 19 | 60 | 56 | 17 | 153 |
| jszabo98 | | | 2 | 15 | 2 | 19 |
| iSazonov | | 1 | 4 | 10 | 2 | 18 |
| doctordns | | 5 | 3 | 5 | 4 | 17 |
| alexandair | 9 | 4 | 2 | | | 15 |
| KirkMunro | | | 7 | 7 | | 14 |
| vexx32 | | | 3 | 11 | | 14 |

<!-- Link references -->
[contrib]: contributing/overview.md
62 changes: 62 additions & 0 deletions reference/docs-conceptual/community/2020-Q2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
title: What's New in PowerShell Docs for 2020-Q2
description: List of changes to the PowerShell documentation
ms.date: 04/29/2020
---

# What's new in PowerShell Docs

This article lists some of the major changes to docs during this previous month and celebrates the
contributions from the community.

Help us make the documentation better for you. Read the [Contributor's Guide][contrib] to learn how
to get started.

## 2020-April Highlights

- New documents
- PowerShell documentation
- [Using Experimental Features](/powershell/scripting/whats-new/experimental-features)
- [about_PSModulePath](/powershell/module/microsoft.powershell.core/about/about_psmodulepath)
- Wiki articles
- [The case for and against Invoke-Expression](https://github.com/MicrosoftDocs/PowerShell-Docs/wiki/The-case-for-and-against-Invoke-Expression)
- [Variables can be assigned values as part of an expression (with limitations)](https://github.com/MicrosoftDocs/PowerShell-Docs/wiki/Variables-can-be-assigned-values-as-part-of-an-expression-(with-limitations))

- Documentation maintenance
- Now publishing the live branch to the website on a schedule
- Monday-Friday 3pm Redmond Time (UTC-8)
- Restructured the Community content
- Many editorial cleanups
- Updated Contributor Guide
- Clarified some formatting rules
- New information about table formatting

- GitHub stats
- 74 PRs merged (8 from Community)
- 79 issues opened (71 from Community)
- 102 issues closed

### Top Community Contributors

The following people have contributed to PowerShell docs by submitting pull requests or filling
issues. Thank you!

- Jonathan-Quilter - 1 PR & 1 issue
- ScSurber - 1 PR & 1 issue
- alexandair - 1 PR
- bmkaiser - 1 PR
- hyoshioka0128 - 1 PR
- jpomfret - 1 PR
- raydixon - 1 PR
- signalwarrant - 1 PR
- mklement0 - 8 issues
- reinierk - 3 issues
- scabon - 2 issues
- Abdullah0820 - 2 issues
- awooga - 2 issues
- Damag3d - 2 issues
- Fiasco123 - 2 issues
- Jasonthurston - 2 issues

<!-- Link references -->
[contrib]: contributing/overview.md
14 changes: 3 additions & 11 deletions reference/docs-conceptual/community/community-support.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,13 @@
---
title: PowerShell community resources
title: PowerShell community support resources
description: List of resources created for and by PowerShell users
ms.date: 03/04/2020
ms.date: 04/29/2020
---
# PowerShell community resources
# Getting support from the community

The PowerShell Community is a vibrant and active group of users. This article can help you get
connected with other member of the community.

## Getting support from the community

The PowerShell community can file issues, bugs, or feature requests in our
[GitHub](https://github.com/powershell/powershell/issues) repository. If you have questions, you may
find help from other members of the community in one of these public forums:
Expand All @@ -25,9 +23,3 @@ find help from other members of the community in one of these public forums:

For information about our support policy, see the
[PowerShell Support Lifecycle](/powershell/scripting/powershell-support-lifecycle).

## Looking for logos and other digital goodies

We have a collection of digital artwork available for your enjoyment.

[Digital Art](/powershell/scripting/community/digital-art)
63 changes: 63 additions & 0 deletions reference/docs-conceptual/community/community-update.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
### YamlMime:Landing

title: Community Update # < 60 chars
summary: A list of resources and a summary of new articles and community contributions. # < 160 chars

metadata:
title: Community Update # Required; page title displayed in search results. Include the brand. < 60 chars.
description: A list of resources and a summary of new articles and community contributions. # < 160 chars
ms.topic: landing-page # Required
author: sdwheeler #Required; your GitHub user alias, with correct capitalization.
ms.author: sewhee #Required; microsoft alias of author; optional team alias.
ms.date: 04/29/2020

# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn |
# overview | quickstart | reference | tutorial | video | whats-new

landingContent:
# Cards and links should be based on top customer tasks or top subjects
# Start card title with a verb
- title: Community resources
linkLists:
- linkListType: overview
links:
- text: Community support
url: community-support.md
- text: Digital art
url: digital-art.md
- text: Contributor Hall of Fame
url: hall-of-fame.md
- title: What's new in PowerShell Docs
linkLists:
- linkListType: whats-new
links:
- text: 2020-Q2
url: ./2020-Q2.md
- text: 2020-Q1
url: ./2020-Q1.md
- title: Get involved - contribute to PowerShell docs
linkLists:
- linkListType: overview
links:
- text: PowerShell Contributor Guide
url: contributing/overview.md
- text: Get started writing
url: contributing/get-started-writing.md
- linkListType: how-to-guide
links:
- text: How to file an issue
url: contributing/file-an-issue.md
- text: Submitting a pull request
url: contributing/pull-requests.md
- text: PowerShell-Docs style guide
url: contributing/powershell-style-guide.md
- text: Editing cmdlet reference
url: contributing/editing-cmdlet-ref.md
- linkListType: reference
links:
- text: Editorial checklist
url: contributing/editorial-checklist.md
- text: How we manage issues
url: contributing/managing-issues.md
- text: How we manage pull requests
url: contributing/managing-pull-requests.md
55 changes: 55 additions & 0 deletions reference/docs-conceptual/community/hall-of-fame.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: What's New in PowerShell Docs
description: List of changes to the PowerShell documentation
ms.date: 04/29/2020
---
# Community Contributor Hall of Fame

The PowerShell Community is a vibrant and collaborative group. We greatly appreciate all the help
and support we get from the community. Learn how you can contribute by reading the
[Contributor's Guide][contrib].

As of April 2020, these GitHub users are the All-Time Top Community Contributors.

### Pull Requests opened

Pull Requests help us fix those issues and make the documentation better for everyone.

| Docs PRs Submitted | 2016 | 2017 | 2018 | 2019 | 2020 | Grand Total |
| ------------------ | ---: | ---: | ---: | ---: | ---: | ----------: |
| Community | 198 | 448 | 468 | 322 | 38 | 1477 |
| matt9ucci | | 157 | 80 | 30 | | 267 |
| nschonni | | | 14 | 138 | | 152 |
| kiazhi | 25 | 79 | 12 | | | 116 |
| alexandair | 59 | 8 | 26 | 2 | 1 | 96 |
| doctordns | 5 | 32 | 20 | 7 | 2 | 66 |
| sethvs | | 1 | 44 | | | 45 |
| Dan1el42 | 20 | | | | | 20 |
| NReilingh | 2 | | 13 | 3 | | 18 |
| it-praktyk | | | 16 | 1 | | 17 |
| vors | 15 | 1 | | | | 16 |
| markekraus | | 11 | 5 | | | 16 |
| purdo17 | | | 13 | | | 13 |
| k-takai | | | 5 | 1 | 7 | 13 |
| kvprasoon | 2 | 1 | 7 | 2 | | 12 |
| PlagueHO | 10 | | | 1 | | 11 |
| exchange12rocks | | 7 | 3 | | | 10 |
| KirkMunro | 1 | 1 | 2 | 6 | | 10 |

### GitHub issues opened

GitHub issues help us identify errors and gaps in our documentation.

| Docs Issues opened | 2016 | 2017 | 2018 | 2019 | 2020 | Grand Total |
| ------------------ | ---: | ---: | ---: | ---: | ---: | ----------: |
| Community | 48 | 93 | 212 | 575 | 212 | 1152 |
| mklement0 | | 19 | 60 | 56 | 26 | 161 |
| jszabo98 | | | 2 | 15 | 3 | 20 |
| iSazonov | | 1 | 4 | 10 | 4 | 19 |
| doctordns | | 5 | 3 | 5 | 4 | 17 |
| alexandair | 9 | 4 | 2 | | | 15 |
| vexx32 | | | 3 | 11 | | 14 |
| KirkMunro | | | 7 | 7 | | 14 |

<!-- Link references -->
[contrib]: contributing/overview.md
19 changes: 14 additions & 5 deletions reference/docs-conceptual/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -731,13 +731,20 @@
- name: Appendix 2 Creating a custom powershell shortcut
href: samples/appendix-2---creating-a-custom-powershell-shortcut.md
- name: Community
expanded: true
items:
- name: Community resources
- name: Community update
href: community/community-update.yml
- name: Community support
href: community/community-support.md
- name: Digital art
href: community/digital-art.md
- name: What's new in PowerShell Docs
href: community/whats-new-in-docs.md
- name: Contributor Hall of Fame
href: community/hall-of-fame.md
- name: What's new in Docs
items:
- name: 2020-Q2
href: community/2020-Q2.md
- name: 2020-Q1
href: community/2020-Q1.md
- name: Contributor's Guide
items:
- name: Overview
Expand All @@ -760,6 +767,8 @@
href: community/contributing/managing-issues.md
- name: How we manage pull requests
href: community/contributing/managing-pull-requests.md
- name: Digital art
href: community/digital-art.md
- name: PowerShell SDK
items:
- name: Overview
Expand Down
15 changes: 12 additions & 3 deletions reference/docs-conceptual/whats-new/experimental-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,22 @@ description: Lists the currently available experimental features and how to use
The Experimental Features support in PowerShell provides a mechanism for experimental features to
coexist with existing stable features in PowerShell or PowerShell modules.

This article describes the experimental features that are available and how to use the feature. For
more information about enabling or disabling these features, see
An experimental feature is one where the design is not finalized. The feature is available for users
to test and provide feedback. Once an experimental feature is finalized, the design changes become
breaking changes.

> [!CAUTION]
> Experimental features aren't intended to be used in production since the changes are allowed to be
> breaking. Experimental features are not officially supported. However, we appreciate any feedback
> and bug reports. You can file issues in the
> [GitHub source repository](https://github.com/PowerShell/PowerShell/issues/new/choose).
For more information about enabling or disabling these features, see
[about_Experimental_Features](/powershell/module/microsoft.powershell.core/about/about_experimental_features).

## Available features

The following table lists the feature that are available in various versions of PowerShell.
This article describes the experimental features that are available and how to use the feature.

| Name | 6.2 | 7.0 | 7.1 (preview) |
| ---------------------------------------------------------- | :-----: | :-----: | :-----------: |
Expand Down

0 comments on commit cdb089a

Please sign in to comment.