mirror of
https://github.com/PowerShell/PowerShell
synced 2026-06-08 12:12:50 +00:00
(WIP) Updated draft of readme for PM review.
This commit is contained in:
@@ -1,13 +1,15 @@
|
||||
 PowerShell
|
||||
========================
|
||||
|
||||
PowerShell is a task automation and configuration management framework,
|
||||
consisting of a command-line shell and associated scripting language built using the [.NET Command Line Interface](https://github.com/dotnet/cli).
|
||||
PowerShell provides full access to COM and WMI, enabling administrators to perform administrative tasks on both local and remote Windows, Linux and OSX systems.
|
||||
PowerShell is a task automation and configuration management platform,
|
||||
consisting of a command-line shell and associated scripting language built
|
||||
using the [.NET Command Line Interface](https://github.com/dotnet/cli).
|
||||
PowerShell provides full access to COM and WMI, enabling administrators to
|
||||
automate administrative tasks on both local and remote Windows, Linux and OSX systems.
|
||||
|
||||
## New to PowerShell?
|
||||
If you are new to PowerShell and would like to learn more,
|
||||
we recommend reviewing our [getting started documentation](https://msdn.microsoft.com/en-us/powershell/scripting/getting-started/getting-started-with-windows-powershell).
|
||||
If you are new to PowerShell and would like to learn more, we recommend
|
||||
reviewing the [getting started documentation](https://msdn.microsoft.com/en-us/powershell/scripting/getting-started/getting-started-with-windows-powershell).
|
||||
|
||||
Build Status
|
||||
------------
|
||||
@@ -23,26 +25,32 @@ Get PowerShell
|
||||
|
||||
| | Linux | Windows .NET Core | Windows .NET Full | OS X | PSRP |
|
||||
|-----------------------|-------|-------------------|-------------------|------|------|
|
||||
| Build from **Source** | [Instructions](docs/building/linux.md) | [Instructions](docs/building/windows-core.md) | [Instructions](docs/building/windows-full.md) | [Instructions](docs/building/osx.md) | [Instructions][psrp] |
|
||||
| Get **Binaries** | [Releases][] | [Releases][] | [Artifacts][] | [Releases][] | TBD |
|
||||
|
||||
|
||||
> Not sure what these are intended for...
|
||||
[releases](https://github.com/PowerShell/PowerShell/releases)
|
||||
[artifacts](https://ci.appveyor.com/project/PowerShell/powershell/build/artifacts)
|
||||
[psrp](https://github.com/PowerShell/psl-omi-provider)
|
||||
| Build from **Source** | [Instructions](docs/building/linux.md) | [Instructions](docs/building/windows-core.md) | [Instructions](docs/building/windows-full.md) | [Instructions](docs/building/osx.md) | [Instructions](https://github.com/PowerShell/psl-omi-provider) |
|
||||
| Get **Binaries** | [Releases](https://github.com/PowerShell/PowerShell/releases) | [Releases](https://github.com/PowerShell/PowerShell/releases) | [Artifacts](https://ci.appveyor.com/project/PowerShell/powershell/build/artifacts) | [Releases](https://github.com/PowerShell/PowerShell/releases) | TBD |
|
||||
|
||||
If installing PowerShell from a package, please refer to the installation
|
||||
documents for [Linux](docs/installation/linux.md) and [Windows](docs/installation/windows.md).
|
||||
|
||||
Developing and Contributing
|
||||
--------------------------
|
||||
If you are new to GIT, we recommend you start by reviewing our [GIT basics document](docs/git/basics.md) where you will find installation instructions, cheatsheets and links to our favorite GIT tutorials.
|
||||
We also recommend, reviewing an example of a [basic GIT commit walkthrough](docs/git/committing.md).
|
||||
If you are new to GIT, we recommend you start by reviewing our
|
||||
[GIT basics document](docs/git/basics.md) where you will find GIT installation
|
||||
instructions, cheat sheets and links to our favorite GIT tutorials. We also
|
||||
recommend, reviewing an example of a [basic GIT commit walkthrough](docs/git/committing.md).
|
||||
|
||||
To begin development, you'll need to setup your development environment for either [Linux](docs/building/linux.md), [Windows](docs/building/windows.md) or [OSX]() and are encouraged to review our [coding guidelines and best practices](docs/coding-guidelines/coding.md) for contributors.
|
||||
To begin development, you'll need to setup your development environment for
|
||||
either [Linux](docs/building/linux.md), [Windows](docs/building/windows.md) or
|
||||
[OSX](docs/building/osx.md) and are encouraged to review the
|
||||
[contribution guidelines](.github/CONTRIBUTING.md) for specific workflow, test
|
||||
requirements and coding guidelines.
|
||||
|
||||
Review our [contribution guidelines](.github/CONTRIBUTING.md) for specific workflow and test requirements.
|
||||
If you encounter issues, please consult the [known issues](docs/KNOWNISSUES.md)
|
||||
and [FAQ](docs/FAQ.md) documents to see if the issue you are running into is
|
||||
captured and if a workaround exists.
|
||||
|
||||
If you encounter issues, please see our [known issues](docs/KNOWNISSUES.md) and [FAQ](docs/FAQ.md) documents. Alternatively, you can submit a [new issue](https://github.com/PowerShell/PowerShell/issues/new).
|
||||
If do not see your issue captured, please file a
|
||||
[new issue](https://github.com/PowerShell/PowerShell/issues/new) using the
|
||||
appropriate issue tag.
|
||||
|
||||
PowerShell Community
|
||||
--------------------
|
||||
@@ -50,4 +58,7 @@ PowerShell Community
|
||||
|
||||
Legal and Licensing
|
||||
-------------------
|
||||
|
||||
`TODO` Missing license details
|
||||
|
||||
`TODO` Missing link to contributor agreement
|
||||
|
||||
Reference in New Issue
Block a user