Skip to content

Commit b41093b

Browse files
Trenlyskanda890
andauthored
Update documentation errors (microsoft#4649)
<!-- To check a checkbox place an "x" between the brackets. e.g: [x] --> - [x] I have signed the [Contributor License Agreement](https://cla.opensource.microsoft.com/microsoft/winget-pkgs). - [x] This pull request is related to an issue. - Resolves microsoft#4619 - Resolves microsoft#4635 ----- Took the branch from Skanda's fork, rebased it and dropped all commits not related to documentation, then squashed all the commits related to documentation ----- ###### Microsoft Reviewers: [Open in CodeFlow](https://microsoft.github.io/open-pr/?codeflow=https://github.com/microsoft/winget-cli/pull/4649) --------- Co-authored-by: SkandaBT <9980056379Skanda@gmail.com>
1 parent 9825812 commit b41093b

4 files changed

Lines changed: 16 additions & 18 deletions

File tree

CODE_OF_CONDUCT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,4 @@ Resources:
66

77
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
88
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
9-
- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
9+
- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns.

CONTRIBUTING.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ Below is our guidance for how to report issues, propose new features, and submit
66

77
The Windows Package Manager team is VERY active in this GitHub Repository. In fact, we live in it all day long and carry out all our development in the open!
88

9-
When the team finds issues we file them in the repository. When we propose new ideas or think-up new features, we file new feature requests. When we work on fixes or features, we create branches and work on those improvements. And when PRs are reviewed, we review in public - including all the good, the bad, and the ugly parts.
9+
When the team finds issues we file them in the repository. When we propose new ideas or think up new features, we file new feature requests. When we work on fixes or features, we create branches and work on those improvements. And when PRs are reviewed, we review them in public - including all the good, the bad, and the ugly parts.
1010

11-
The point of doing all this work in public is to ensure that we are holding ourselves to a high degree of transparency, and so that the community sees that we apply the same processes and hold ourselves to the same quality-bar as we do to community-submitted issues and PRs. We also want to make sure that we expose our team culture and "tribal knowledge" that is inherent in any closely-knit team, which often contains considerable value to those new to the project who are trying to figure out "why the heck does this thing look/work like this???"
11+
The point of doing all this work in public is to ensure that we are holding ourselves to a high degree of transparency, and so that the community sees that we apply the same processes and hold ourselves to the same quality bar as we do to community-submitted issues and PRs. We also want to make sure that we expose our team culture and "tribal knowledge" that is inherent in any closely-knit team, which often contains considerable value to those new to the project who are trying to figure out "why the heck does this thing look/work like this???"
1212

1313
### Repository Bot
1414

@@ -79,27 +79,27 @@ For those able & willing to help fix issues and/or implement features ...
7979

8080
Some issues/features may be quick and simple to describe and understand. For such scenarios, once a team member has agreed with your approach, skip ahead to the section headed "Fork, Branch, and Create your PR", below.
8181

82-
Small issues that do not require a spec will be labelled Issue-Bug or Issue-Task.
82+
Small issues that do not require a spec will be labeled Issue-Bug or Issue-Task.
8383

8484
However, some issues/features will require careful thought & formal design before implementation. For these scenarios, we'll request that a spec is written and the associated issue will be labeled Issue-Feature.
8585

86-
Specs help collaborators discuss different approaches to solve a problem, describe how the feature will behave, how the feature will impact the user, what happens if something goes wrong, etc. Driving towards agreement in a spec, before any code is written, often results in simpler code, and less wasted effort in the long run.
86+
Specs help collaborators discuss different approaches to solving a problem, describe how the feature will behave, how the feature will impact the user, what happens if something goes wrong, etc. Driving towards agreement in a spec, before any code is written, often results in simpler code, and less wasted effort in the long run.
8787

88-
Specs will be managed in a very similar manner as code contributions so please follow the "Fork, Branch and Create your PR" below.
88+
Specs will be managed in a very similar manner as code contributions so please follow the "Fork, Branch, and Create your PR" below.
8989

9090
### Writing / Contributing-to a Spec
9191

92-
To write/contribute to a spec: fork, branch and commit via PRs, as you would with any code changes.
92+
To write/contribute to a spec: fork, branch, and commit via PRs, as you would with any code changes.
9393

94-
Specs are written in markdown, stored under the `/doc/specs` folder and named `[issue id] - [spec description].md`.
94+
Specs are written in markdown, stored under the `/doc/specs` folder, and named `[issue id] - [spec description].md`.
9595

9696
👉 **It is important to follow the spec templates and complete the requested information**. The available spec templates will help ensure that specs contain the minimum information & decisions necessary to permit development to begin. In particular, specs require you to confirm that you've already discussed the issue/idea with the team in an issue and that you provide the issue ID for reference.
9797

9898
Team members will be happy to help review specs and guide them to completion.
9999

100100
### Help Wanted
101101

102-
Once the team have approved an issue/spec, development can proceed. If no developers are immediately available, the spec can be parked ready for a developer to get started. Parked specs' issues will be labeled "Help Wanted". To find a list of development opportunities waiting for developer involvement, visit the Issues and filter on [the Help-Wanted label](https://github.com/microsoft/winget-cli/labels/Help%20Wanted).
102+
Once the team has approved an issue/spec, development can proceed. If no developers are immediately available, the spec can be parked ready for a developer to get started. Parked specs' issues will be labeled "Help Wanted". To find a list of development opportunities waiting for developer involvement, visit the Issues and filter on [the Help-Wanted label](https://github.com/microsoft/winget-cli/labels/Help%20Wanted).
103103

104104
---
105105

@@ -122,9 +122,9 @@ Testing is a key component in the development workflow.
122122

123123
### Code Review
124124

125-
When you'd like the team to take a look, (even if the work is not yet fully-complete), mark the Draft PR as 'Ready For Review' so that the team can review your work and provide comments, suggestions, and request changes. It may take several cycles, but the end result will be solid, testable, conformant code that is safe for us to merge.
125+
When you'd like the team to take a look, (even if the work is not yet fully-complete), mark the Draft PR as 'Ready For Review' so that the team can review your work and provide comments, suggestions, and request changes. It may take several cycles, but the result will be solid, testable, conformant code that is safe for us to merge.
126126

127-
> ⚠ Remember: **changes you make may affect both the Windows Package Manager and the schema support implemented in our validation pipelines!** Because of this, we will treat community PR's with the same level of scrutiny and rigor as commits submitted to the official Windows source by team members and partners.
127+
> ⚠ Remember: **changes you make may affect both the Windows Package Manager and the schema support implemented in our validation pipelines!** Because of this, we will treat community PRs with the same level of scrutiny and rigor as commits submitted to the official Windows source by team members and partners.
128128
129129
### Merge
130130

README.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,9 @@ Please read our [troubleshooting guide](/doc/troubleshooting/README.md).
4646

4747
Installer behavior can be different depending on whether you are running **winget** with administrator privileges.
4848

49-
* When running **winget** without administrator privileges, some applications may [require elevation](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works) to install. When the installer runs, Windows will prompt you to [elevate](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works#the-uac-user-experience). If you choose not to elevate, the application will fail to install.
49+
* When running **WinGet** without administrator privileges, some applications may [require elevation](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works) to install. When the installer runs, Windows will prompt you to [elevate](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works#the-uac-user-experience). If you choose not to elevate, the application will fail to install.
5050

51-
* When running **winget** in an Administrator Command Prompt, you will not see [elevation prompts](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works#the-uac-user-experience) if the application requires it. Always use caution when running your command prompt as an administrator, and only install applications you trust.
51+
* When running **WinGet** in an Administrator Command Prompt, you will not see [elevation prompts](https://docs.microsoft.com/windows/security/identity-protection/user-account-control/how-user-account-control-works#the-uac-user-experience) if the application requires it. Always use caution when running your command prompt as an administrator, and only install applications you trust.
5252

5353
### Build your own
5454

@@ -88,14 +88,14 @@ The client is built around the concept of sources; a set of packages effectively
8888
2. Configure your system, please use the [configuration file](.configurations/configuration.dsc.yaml). This can be applied by either:
8989
* [Dev Home](https://github.com/microsoft/devhome)'s machine configuration tool
9090
* WinGet configuration. Run `winget configure .configurations/configuration.dsc.yaml` from the project root so relative paths resolve correctly.
91-
3. Run `vcpkg integrate install` from the Developer Command Prompt for VS 2022. This is a one time setup step until the configuration file in step 2 is updated to work with vcpkg setup.
91+
3. Run `vcpkg integrate install` from the Developer Command Prompt for VS 2022. This is a one-time setup step until the configuration file in step 2 is updated to work with vcpkg setup.
9292

9393
### Prerequisites
9494

9595
* Windows 10 1809 (17763) or later
9696
* [Developer Mode enabled](https://docs.microsoft.com/windows/uwp/get-started/enable-your-device-for-development)
9797
* [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/)
98-
* Or use winget to install it ;) (although you may need to adjust the workloads via Tools->Get Tools and Features...)
98+
* Or use WinGet to install it ;) (although you may need to adjust the workloads via Tools->Get Tools and Features...)
9999
* The following workloads:
100100
* .NET Desktop Development
101101
* Desktop Development with C++
@@ -118,8 +118,7 @@ We would like to thank [Keivan Beigi (@kayone)](https://github.com/kayone) for h
118118
## Contributing
119119

120120
This project welcomes contributions and suggestions. Most contributions require you to agree to a
121-
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
122-
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. More
121+
Contributor License Agreement (CLA) declaring that you have the right to, and do, actually grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. More
123122
information is available in our [CONTRIBUTING.md](/CONTRIBUTING.md) file.
124123

125124
When you submit a pull request, a CLA bot will automatically determine whether you need to provide

SECURITY.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
<!-- BEGIN MICROSOFT SECURITY.MD V0.0.9 BLOCK -->
2-
32
## Security
43

54
Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) and [Xamarin](https://github.com/xamarin).

0 commit comments

Comments
 (0)