Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: don't allow FQDN links #21432

Merged
merged 10 commits into from
Nov 11, 2022
7 changes: 7 additions & 0 deletions .markdownlint-cli2.jsonc
Original file line number Diff line number Diff line change
Expand Up @@ -184,6 +184,13 @@
"searchPattern": "/- :(\\w)/g",
"replace": "- : $1",
"skipCode": true
},
{
"name": "fqdn-moz-links",
"message": "Don't use developer.mozilla.org for links",
"search": "](https://developer.mozilla.org/",
"replace": "](/",
"skipCode": true
}
]
}
Expand Down
34 changes: 23 additions & 11 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,25 +4,25 @@ Thanks for taking the time to contribute to [MDN Web Docs](https://developer.moz

This document covers project setup steps along with a set of guidelines for contributing to MDN Web Docs content.
Everyone participating in this project is expected to follow our [Code of Conduct](CODE_OF_CONDUCT.md).
If you want to jump right in, see [Getting started on MDN](https://developer.mozilla.org/en-US/docs/MDN/Community/Contributing/Getting_started) for an overview of how to join, and the [Contribute page](https://developer.mozilla.org/en-US/docs/MDN/Contribute) on MDN for a filtered list of tasks.
If you want to jump right in, see [Getting started on MDN][] for an overview of how to join, and the [Contribute page][] on MDN for a filtered list of tasks.

## Getting started

Before contributing, make sure you're familiar with the project guidelines and conventions:

- [MDN guidelines](https://developer.mozilla.org/en-US/docs/MDN/Guidelines) - This page covers everything from how and what we write to general project guidelines.
- [Writing style guide](https://developer.mozilla.org/en-US/docs/MDN/Guidelines/Writing_style_guide) - This covers the language and style we use and how we write and format code examples.
- [Guide to writing Markdown for MDN](https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN) - Which Markdown features we support and custom extensions we've added.
- [MDN guidelines][] - This page covers everything from how and what we write to general project guidelines.
- [Writing style guide][] - This covers the language and style we use and how we write and format code examples.
- [Guide to writing Markdown for MDN][] - Which Markdown features we support and custom extensions we've added.

### Prerequisite knowledge

We expect contributors to MDN to have some knowledge of web technologies before working on content.
We've put together relevant resources to get up to speed on specific topics before contributing:

- **Open source:** If you're new to open source projects, see the [open source etiquette](https://developer.mozilla.org/en-US/docs/MDN/Contribute/Open_source_etiquette) page.
- **Git and GitHub:** If you are unfamiliar with these, [GitHub for complete beginners](https://developer.mozilla.org/en-US/docs/MDN/Contribute/GitHub_beginners) is a good primer.
- **Web technologies:** HTML, CSS, JavaScript, and more are covered in our [Learn web development](https://developer.mozilla.org/en-US/docs/Learn) tutorials.
- **MDN repository:** To find out where everything lives, see [Where is everything on MDN?](https://developer.mozilla.org/en-US/docs/MDN/Contribute/Where_is_everything).
- **Open source:** If you're new to open source projects, see the [open source etiquette][] page.
- **Git and GitHub:** If you are unfamiliar with these, [GitHub for complete beginners][] is a good primer.
- **Web technologies:** HTML, CSS, JavaScript, and more are covered in our [Learn web development][] tutorials.
- **MDN repository:** To find out where everything lives, see [Where is everything on MDN?][].

### Documentation conventions

Expand All @@ -42,7 +42,7 @@ Each document's `index.md` starts with front-matter, which is written in [YAML](
The YAML is read by the MDN build system and is used to read the metadata of a document.

The front-matter must be the first thing in the file and must take the form of valid YAML set between triple-dashed lines (`---`).
Front-matter defines the document's `title`, `slug`, and optional [`tags`](https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Howto/Tag).
Front-matter defines the document's `title`, `slug`, and optional [`tags`][].
Here's an example of front-matter from the [JavaScript page](files/en-us/web/javascript/index.md):

```yaml
Expand Down Expand Up @@ -75,7 +75,7 @@ If you've created a new GitHub account and want to know what to do next, you can
### Simple changes

If you want to make a small change like fixing a typo, the GitHub UI is the easiest way to get started.
If you've found a typo on the [JavaScript landing page](https://developer.mozilla.org/en-US/docs/Web/JavaScript), for example, you can propose a fix as follows:
If you've found a typo on the [JavaScript landing page][], for example, you can propose a fix as follows:

1. Sign in to [GitHub](https://github.com/)
2. Navigate to [https://github.com/mdn/content](https://github.com/mdn/content)
Expand Down Expand Up @@ -226,7 +226,7 @@ There are a few things to keep in mind:
- Documents must be written in Markdown.
- A document is represented by an `index.md` file.
- If you're creating a new CSS document for a property called `foo`, create a new folder `files/en-us/web/css/foo/` and put the Markdown file in this folder (`files/en-us/web/css/foo/index.md`).
- A document's `index.md` file must start with front-matter that defines the `title`, `slug`, and optional [`tags`](https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Howto/Tag).
- A document's `index.md` file must start with front-matter that defines the `title`, `slug`, and optional [`tags`][].
You might find it helpful to refer to the front-matter within a similar document's `index.md`.

### Moving documents
Expand Down Expand Up @@ -402,3 +402,15 @@ There are some important rules of etiquette to remember that will help during th

When contributing to the content you agree to license your contributions
according to [our license](LICENSE.md).

[`tags`]: https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Howto/Tag
[Contribute page]: https://developer.mozilla.org/en-US/docs/MDN/Contribute
[Getting started on MDN]: https://developer.mozilla.org/en-US/docs/MDN/Community/Contributing/Getting_started
[GitHub for complete beginners]: https://developer.mozilla.org/en-US/docs/MDN/Contribute/GitHub_beginners
[Guide to writing Markdown for MDN]: https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN
[JavaScript landing page]: https://developer.mozilla.org/en-US/docs/Web/JavaScript
[Learn web development]: https://developer.mozilla.org/en-US/docs/Learn
[MDN guidelines]: https://developer.mozilla.org/en-US/docs/MDN/Guidelines
[open source etiquette]: https://developer.mozilla.org/en-US/docs/MDN/Contribute/Open_source_etiquette
[Where is everything on MDN?]: https://developer.mozilla.org/en-US/docs/MDN/Contribute/Where_is_everything
[Writing style guide]: https://developer.mozilla.org/en-US/docs/MDN/Guidelines/Writing_style_guide
bsmth marked this conversation as resolved.
Show resolved Hide resolved
bsmth marked this conversation as resolved.
Show resolved Hide resolved
10 changes: 7 additions & 3 deletions REVIEWING.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,11 +42,11 @@ perfectly in accordance with all of these points immediately. It is more
important to make sure the content is readable, useful, correct, and not
inappropriate, than it is to follow every guideline to the letter.

1. Familiarize yourself with the [MDN Code example guidelines](https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide)
1. Familiarize yourself with the [MDN Code example guidelines][]
and make sure that code examples follow the guidelines. You'll get used to
them eventually, and we are intending to automatically lint against our
guidelines at some point in the future.
2. Familiarize yourself with the [MDN Writing style guide](https://developer.mozilla.org/en-US/docs/MDN/Guidelines/Writing_style_guide),
2. Familiarize yourself with the [MDN Writing style guide][],
and use it to inform your reviews of new text content.
3. Familiarize yourself with the MDN [pull request guidelines](https://github.com/mdn/content/blob/main/README.md#pull-request-etiquette).
The key points here are
Expand Down Expand Up @@ -134,7 +134,7 @@ then don't review the pull request — just wait for an approval request.
The following specific topic areas are being reviewed by the kind souls listed
underneath them. Be kind to them, and thank them for all the help they give
to this project. If you would like to help with MDN content reviews,
[get in touch with us](https://developer.mozilla.org/en-US/docs/MDN/Community/Contributing/Getting_started#Step_4_Ask_for_help).
[get in touch with us][].

Note that changes to any content areas not explicitly listed below will be
handled by the [@core-yari-content](https://github.com/orgs/mdn/teams/core-yari-content)
Expand Down Expand Up @@ -206,3 +206,7 @@ longer have the time to contribute; we want to give them our sincere thanks
for all their help.

- [@vkWeb](https://github.com/vkWeb/)

[get in touch with us]: https://developer.mozilla.org/en-US/docs/MDN/Community/Contributing/Getting_started#Step_4_Ask_for_help
[MDN Code example guidelines]: https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide
[MDN Writing style guide]: https://developer.mozilla.org/en-US/docs/MDN/Guidelines/Writing_style_guide
2 changes: 1 addition & 1 deletion files/en-us/mdn/community/pull_requests/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ Don't:

## Deployment timeline

After your pull request is merged to [`mdn/content`](https://github.com/mdn/content), it can take up to 48 hours before your changes are live on the [production site](https://developer.mozilla.org/), but it's usually quicker.
After your pull request is merged to [`mdn/content`](https://github.com/mdn/content), it can take up to 48 hours before your changes are live on the [production site](/), but it's usually quicker.
The site build runs every 24 hours at around 19:00 US/Eastern time, and is deployed immediately after.
When deploys succeed, it can take up to 24 hours for the CDN to invalidate caches and serve new content.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ If someone wants to donate an article to MDN that they previously published on t

**If the content is published under an open license:**

- Say what it is, and link to the license so we can check whether it is compatible with [MDN's license](https://developer.mozilla.org/en-US/docs/MDN/About#using_mdn_web_docs_content).
- Say what it is, and link to the license so we can check whether it is compatible with [MDN's license](https://github.com/mdn/content/blob/main/LICENSE.md).

## Linking to MDN Web Docs articles

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/html/element/video/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '<video>: The Video Embed element'
title: "<video>: The Video Embed element"
slug: Web/HTML/Element/video
tags:
- Element
Expand Down Expand Up @@ -183,7 +183,7 @@ Like all other HTML elements, this element supports the [global attributes](/en-
{{domxref("HTMLMediaElement.error_event", 'error')}}
</td>
<td>
An error occurred while fetching the media data, or the type of the
An error occurred while fetching the media data, or the type of the
resource is not a supported media format.
</td>
</tr>
Expand Down