diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 00000000..afc63ba1 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,15 @@ +# EditorConfig is awesome: https://EditorConfig.org + +# top-most EditorConfig file +root = true + +[*] +indent_style = space +indent_size = 2 +end_of_line = lf +charset = utf-8 +trim_trailing_whitespace = true +insert_final_newline = true + +[*.md] +trim_trailing_whitespace = false diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 00000000..8c045e99 --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,13 @@ +# This file is used to request PR reviews from the appropriate team. +# +# Order is important; the last matching pattern takes precedence. +# Each rule is more specific than the previous rules. +# For more information, see: +# https://docs.github.com/en/free-pro-team@latest/github/creating-cloning-and-archiving-repositories/about-code-owners + +# Default +* @mdn/content-team + +/.github/workflows/ @mdn/engineering +/.github/CODEOWNERS @mdn/content-team @mdn/engineering +/SECURITY.md @mdn/engineering diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml new file mode 100644 index 00000000..5640bef1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -0,0 +1,36 @@ +name: "Issue report" +description: Report an unexpected problem or unintended behavior. +labels: ["needs triage"] +body: + - type: markdown + attributes: + value: | + ### Before you start + + **Want to fix the problem yourself?** This project is open source and we welcome fixes and improvements from the community! + + ↩ Check the project [CONTRIBUTING.md](../blob/main/CONTRIBUTING.md) guide to see how to get started. + + --- + - type: textarea + id: problem + attributes: + label: What was incorrect, unhelpful, or incomplete? + validations: + required: true + - type: textarea + id: expected + attributes: + label: What did you expect to see? + validations: + required: true + - type: textarea + id: references + attributes: + label: Do you have any supporting links, references, or citations? + description: Link to information that helps us confirm your issue. + - type: textarea + id: more-info + attributes: + label: Do you have anything more you want to share? + description: For example, steps to reproduce, screenshots, screen recordings, or sample code. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..5cd3f68e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,11 @@ +blank_issues_enabled: false +contact_links: + - name: MDN GitHub Discussions + url: https://github.com/orgs/mdn/discussions + about: Does the issue involve a lot of pages, or are you not sure how it can be split into actionable tasks? Consider starting a discussion first. + - name: MDN Web Docs on Discourse + url: https://discourse.mozilla.org/c/mdn/learn/250 + about: Need help with assessments on MDN Web Docs? We have a support community for this purpose on Discourse. + - name: Help with code + url: https://stackoverflow.com/ + about: If you are stuck and need help with code, StackOverflow is a great resource. diff --git a/.github/PULL_REQUEST_TEMPLATE b/.github/PULL_REQUEST_TEMPLATE new file mode 100644 index 00000000..d85c3d5c --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE @@ -0,0 +1,21 @@ + + +**Description:** + + + +**Motivation:** + + + +**Additional details:** + + + +**Related issues and pull requests:** + + + + + + diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 00000000..f90e9084 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,8 @@ +version: 2 +updates: + - package-ecosystem: github-actions + directory: / + schedule: + interval: weekly + commit-message: + prefix: "ci(deps): " diff --git a/.github/workflows/lock-closed.yml b/.github/workflows/lock-closed.yml new file mode 100644 index 00000000..1b33797c --- /dev/null +++ b/.github/workflows/lock-closed.yml @@ -0,0 +1,14 @@ +name: "Lock old issues and pull requests" +on: + schedule: + - cron: "0 9 1 * *" + +permissions: + issues: write + pull-requests: write + +jobs: + lock: + uses: mdn/workflows/.github/workflows/lock-closed.yml@main + with: + target-repo: "mdn/css-examples" diff --git a/.github/workflows/new-issues.yml b/.github/workflows/new-issues.yml new file mode 100644 index 00000000..f0e85f0f --- /dev/null +++ b/.github/workflows/new-issues.yml @@ -0,0 +1,21 @@ +name: "Mark new issues with needs-triage label" + +on: + issues: + types: + - reopened + - opened + +permissions: + issues: write + pull-requests: write + +jobs: + label-new-issues: + runs-on: ubuntu-latest + steps: + - name: initial labelling + uses: andymckay/labeler@3a4296e9dcdf9576b0456050db78cfd34853f260 # master + with: + add-labels: "needs triage" + ignore-if-assigned: true diff --git a/.github/workflows/pr-merge-conflicts.yml b/.github/workflows/pr-merge-conflicts.yml new file mode 100644 index 00000000..c1c1e3f1 --- /dev/null +++ b/.github/workflows/pr-merge-conflicts.yml @@ -0,0 +1,20 @@ +name: "Label PRs with conflicts" + +on: + push: + pull_request_target: + branches: + - main + types: [synchronize] + +permissions: + # Label pull requests. + pull-requests: write + +jobs: + label-merge-conflicts: + uses: mdn/workflows/.github/workflows/pr-rebase-needed.yml@main + with: + target-repo: "mdn/css-examples" + secrets: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/.markdownlint-cli2.jsonc b/.markdownlint-cli2.jsonc new file mode 100644 index 00000000..3395ac2b --- /dev/null +++ b/.markdownlint-cli2.jsonc @@ -0,0 +1,12 @@ +{ + "config": { + "extends": "./.markdownlint.jsonc" + }, + "ignores": [ + "node_modules", + ".git", + ".github", + "tests", + "editable-samples/codemirror" + ] +} diff --git a/.markdownlint.jsonc b/.markdownlint.jsonc new file mode 100644 index 00000000..4431899c --- /dev/null +++ b/.markdownlint.jsonc @@ -0,0 +1,8 @@ +// This file defines our configuration for Markdownlint. See +// https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md +// for more details on each rule. + +{ + "first-line-heading": false, + "line-length": false +} diff --git a/.prettierignore b/.prettierignore new file mode 100644 index 00000000..6ca2a321 --- /dev/null +++ b/.prettierignore @@ -0,0 +1,3 @@ +editable-samples/codemirror/**/* +editable-samples-2/js/ +.markdownlint* diff --git a/.prettierrc.json b/.prettierrc.json new file mode 100644 index 00000000..9c1044f6 --- /dev/null +++ b/.prettierrc.json @@ -0,0 +1,3 @@ +{ + "bracketSameLine": true +} diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 498baa3f..0d424fd8 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -1,10 +1,11 @@ # Community Participation Guidelines -This repository is governed by Mozilla's code of conduct and etiquette guidelines. +This repository is governed by Mozilla's code of conduct and etiquette guidelines. For more details, please read the -[Mozilla Community Participation Guidelines](https://www.mozilla.org/about/governance/policies/participation/). +[Mozilla Community Participation Guidelines](https://www.mozilla.org/about/governance/policies/participation/). ## How to Report + For more information on how to report violations of the Community Participation Guidelines, please read our '[How to Report](https://www.mozilla.org/about/governance/policies/participation/reporting/)' page. - +
-