Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/PowerShellOrg/PowerShellUserGroups

An online source of PowerShell User Group information.
https://github.com/PowerShellOrg/PowerShellUserGroups

powershell

Last synced: 3 months ago
JSON representation

An online source of PowerShell User Group information.

Awesome Lists containing this project

README

        

# PowerShell User Groups

This GitHub repository is intended to serve as a community-maintained, single-source list of PowerShell user groups worldwide. The content of this repository was originally stored at https://github.com/GamerLivingWill.

## Purpose

This list is a central repository of PowerShell user groups that can be updated by the community and used as a source file for other lists and websites. Information for each user group will be maintained in a json data file.

A markdown document, [PowerShellUserGroupList](./PowerShellUserGroupList.md) will be updated as group entries are added or revised. There is also a version [sorted by country and state](./PowerShellGroupsbyLocation.md). We encourage people to link, rather than copy, to these files in order to keep the data fresh and accurate. External sites can link to this page without seeking permission. Everyone wins.

There are long term plans to surface the group information via a REST API or other methods.

## Guidance and Governance

We're still working on the standards surrounding what information to offer and how governance will be administered. We want to keep this conversation open. If you want to raise a suggestion, concern, or ways to improve what we're doing, feel free to raise an issue on this repository and we can all talk about it together!

Please use the pull request process to submit new or modified entries. We prefer that you only modify your own entries. If you feel there is something we should know about a given entry, please post an issue.

_Your entry may be edited for clarity and consistency._

## Sample Layout

Each user group is defined by a json file that should look like this:

```json
{
"Name": "Omaha PowerShell User Group",
"Owner": [
"Boe Prox",
"Josh Duffney"
],
"Location": "Omaha, NE",
"WebsiteURL": "https://twitter.com/OmahaPSUG",
"Twitter": "[@OmahaPSUG](https://twitter.com/OmahaPSUG)",
"Email": "[[email protected]](mailto:[email protected])",
"Country": "USA",
"State": "NE",
"Icon": "https://pbs.twimg.com/profile_images/477061562859933696/3HhR5Upu_400x400.png"
}
```

We strongly recommend that you include either an active Twitter or email account so that you can be contacted about your group.

Markdown is permitted, but it is not required. A PowerShell script, `New-UserGroupEntry.ps1` is available in this repository to make it easier to create an entry for your group. Currently, we are using a file name that includes your group name with space replaced with `_` characters. Try to avoid using special characters like `&` and slashes.

The Icon property is currently not being used in any markdown or PDF output. But this can point to a thumbnail size graphic or icon for your group. Expect that this will be resized when eventually used.

**You do not need to update any markdown files as they are generated fresh after each update. The json file is the only item that needs to be updated. If you prefer, you can email your group information to [email protected] or open an Issue.**

*last updated Friday, August 24, 2018 4:24:09 PM UTC*