Skip to content

Commit 3ff6ede

Browse files
authored
Update meta files (#273)
* Update meta files * Update description for .yml files in CONTRIBUTING.md
1 parent 8bcb6cb commit 3ff6ede

File tree

8 files changed

+527
-443
lines changed

8 files changed

+527
-443
lines changed

CODE_OF_CONDUCT.md

Lines changed: 40 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,44 @@
11
# Microsoft Open Source Code of Conduct
22

3-
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
3+
This project has adopted the [Microsoft Open Source Code of Conduct][02].
44

5-
Resources:
5+
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and
6+
healthy community.
67

7-
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
8-
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
9-
- Contact [[email protected]](mailto:[email protected]) with questions or concerns
10-
- Employees can reach out at [aka.ms/opensource/moderation-support](https://aka.ms/opensource/moderation-support)
8+
## Our Standards
9+
10+
Examples of behavior that contributes to a positive environment for our community include:
11+
12+
- Demonstrating empathy and kindness toward other people
13+
- Being respectful of differing opinions, viewpoints, and experiences
14+
- Giving and gracefully accepting constructive feedback
15+
- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the
16+
experience
17+
- Focusing on what's best not just for us as individuals, but for the overall community
18+
19+
Examples of unacceptable behavior include:
20+
21+
- Disruptive behavior
22+
- Submitting spam comments, issues, or pull requests
23+
- Defacing or vandalizing the project, repository, content, or documentation
24+
- Intentionally introducing security vulnerabilities
25+
- Disrespectful behavior
26+
- Trolling, insulting or derogatory comments, and personal or political attacks
27+
- Public or private harassment
28+
- Publishing others' private information, such as a physical or email address, without their
29+
explicit permission
30+
- The use of sexualized language or imagery, and sexual attention or advances of any kind
31+
- Other conduct that could reasonably be considered inappropriate in a professional setting
32+
33+
## Resources
34+
35+
- [Microsoft Open Source Code of Conduct][02]
36+
- [Microsoft Code of Conduct FAQ][03]
37+
- Contact [[email protected]][04] with questions or concerns
38+
- Employees can reach out at [aka.ms/opensource/moderation-support][01]
39+
40+
<!-- link references -->
41+
[01]: https://aka.ms/opensource/moderation-support
42+
[02]: https://opensource.microsoft.com/codeofconduct/
43+
[03]: https://opensource.microsoft.com/codeofconduct/faq/
44+
[04]: mailto:[email protected]

CONTRIBUTING.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Contributor Guide
2+
3+
Thank you for your interest in contributing to quality documentations. As an open source project, we
4+
welcome input and updates from the community.
5+
6+
The process for contributing to this project is documented in our
7+
[Contributor's Guide](https://aka.ms/PSDocsContributor).
8+
9+
## PowerShell-Docs-DSC structure
10+
11+
There are three categories of content in this repository:
12+
13+
- reference content
14+
- conceptual content
15+
- metadata and configuration files
16+
17+
### Reference content
18+
19+
The reference content is the PowerShell cmdlet reference for the DSC cmdlets. The cmdlet reference
20+
is collected in versioned folders (like dsc-1.1, dsc-2.0, and dsc-3.0). This content is also used to
21+
create the help information displayed by the `Get-Help` cmdlet.
22+
23+
### Conceptual content
24+
25+
The conceptual documentation is also organized by version.
26+
27+
> [!NOTE]
28+
> Anytime a conceptual article is added, removed, or renamed, the TOC must be updated and deleted or
29+
> renamed files must be redirected.
30+
31+
### Metadata files
32+
33+
This project contains several types of metadata files. The metadata files control the behavior of
34+
our build tools and the publishing system. Only PowerShell-Docs maintainers and approved
35+
contributors are allowed to change these files. If you think that a meta file should be changed,
36+
open an issue to discuss the needed changes.
37+
38+
Meta files in the root of the repository
39+
40+
- `.*` - configuration files in the root of the repository
41+
- `*.md` - Project documentation in the root of the repository
42+
- `*.yml` - build automation files
43+
- `.devcontainer/*` - devcontainer configuration files
44+
- `.github/**/*` - GitHub templates, actions, and other meta files
45+
- `.vscode/**/*` - VS Code extension configurations
46+
47+
Meta files in the documentation set
48+
49+
- `dsc/**/*.json` - docset configuration files
50+
- `dsc/**/*.yml` - TOC and other structured content files
51+
- `dsc/**/*.ps1` - Example DSC resources and configurations
52+
- `dsc/breadcrumb/*` - breadcrumb navigation configuration
53+
- `dsc/includes/*` - markdown include files
54+
- `dsc/mapping/*` - version mapping configuration
55+
- `dsc/**/media/**` - image files used in documentation

0 commit comments

Comments
 (0)