├── .babelrc
├── .eslintrc.json
├── .gitignore
├── .prettierrc
├── CODE_OF_CONDUCT.md
├── Jenkinsfile
├── LICENSE
├── README.md
├── bin
├── irc-notify.sh
└── s3-sync.sh
├── build-utils
├── loadPresets.js
├── presets
│ ├── webpack.analyze.js
│ ├── webpack.compress.js
│ └── webpack.sass.js
├── webpack.development.js
└── webpack.production.js
├── contribute.json
├── package-lock.json
├── package.json
├── src
├── .DS_Store
├── App.js
├── components
│ ├── Content.js
│ ├── ContentList.js
│ ├── Footer.js
│ ├── FooterMain.js
│ ├── FooterWebDocs.js
│ ├── Header.js
│ ├── Hero.js
│ ├── IconGithub.js
│ ├── IconTwitter.js
│ ├── SectionContact.js
│ ├── SectionContent.js
│ ├── SectionContribute.js
│ ├── SectionData.js
│ └── SectionPlatform.js
├── fonts
│ ├── .DS_Store
│ ├── ZillaSlab-Bold.woff
│ ├── ZillaSlab-Bold.woff2
│ ├── ZillaSlab-Regular.woff
│ └── ZillaSlab-Regular.woff2
├── media
│ ├── .DS_Store
│ ├── favicon144.png
│ ├── hero-background.svg
│ ├── hero-dino-blank.png
│ ├── hero-dino.png
│ ├── mdn-logo-black.svg
│ ├── mdn-logo-white.svg
│ └── web-docs-sprite.svg
├── style
│ ├── base
│ │ ├── _buttons.scss
│ │ ├── _document.scss
│ │ └── _fonts.scss
│ ├── components
│ │ ├── _contact.scss
│ │ ├── _footer.scss
│ │ ├── _general-content.scss
│ │ ├── _header.scss
│ │ └── _hero.scss
│ ├── main.scss
│ ├── mixins
│ │ └── _typography.scss
│ └── vars
│ │ └── _vars.scss
└── tmpl
│ └── index.html
├── static
├── 6c51deebd4af93c4e602a0e0dd3d9713.png
├── 8d7f01331d2bd45175941561025bd855.woff2
├── be1d6507cb984ac565cbb9ad960eb579.woff
├── cb5d957b5fbd18ef9503278801143a30.svg
├── e52c3a5dbaaac5fe350afdb0ec601019.svg
├── f4223fb8f1149495dee7293643565f8c.svg
├── f7120c75de27afa908563dbf4b373105.woff
├── f9de6143fdfac92af3c709a2240b8ac6.woff2
├── favicon144.png
├── index.html
├── main.06f6fa26803bfb2d0bbe.js
├── main.06f6fa26803bfb2d0bbe.js.map
├── main.css
└── main.css.map
└── webpack.config.js
/.babelrc:
--------------------------------------------------------------------------------
1 | {
2 | "presets": [
3 | "@babel/react",
4 | "@babel/preset-flow",
5 | [
6 | "@babel/env",
7 | {
8 | "targets": {
9 | "browsers": "last 2 versions"
10 | },
11 | "modules": false
12 | }
13 | ]
14 | ],
15 | "plugins": [
16 | "react-hot-loader/babel",
17 | "@babel/plugin-syntax-dynamic-import",
18 | "@babel/plugin-proposal-class-properties"
19 | ]
20 | }
21 |
--------------------------------------------------------------------------------
/.eslintrc.json:
--------------------------------------------------------------------------------
1 | {
2 | "extends": [
3 | "eslint:recommended",
4 | "plugin:import/errors",
5 | "plugin:flowtype/recommended",
6 | "plugin:react/recommended",
7 | "plugin:jsx-a11y/recommended",
8 | "prettier",
9 | "prettier/react"
10 | ],
11 | "rules": {
12 | "react/prop-types": 0,
13 | "no-console": 1
14 | },
15 | "plugins": ["flowtype", "react", "import", "jsx-a11y"],
16 | "parser": "babel-eslint",
17 | "parserOptions": {
18 | "ecmaVersion": 2018,
19 | "sourceType": "module",
20 | "ecmaFeatures": {
21 | "jsx": true
22 | }
23 | },
24 | "env": {
25 | "browser": true,
26 | "es6": true,
27 | "jest": true,
28 | "node": true
29 | }
30 | }
31 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | /node_modules/
2 | /dist/
3 | .vscode
4 | .DS_Store
--------------------------------------------------------------------------------
/.prettierrc:
--------------------------------------------------------------------------------
1 | {}
--------------------------------------------------------------------------------
/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
1 | # Community Participation Guidelines
2 |
3 | This repository is governed by Mozilla's code of conduct and etiquette guidelines.
4 | For more details, please read the
5 | [Mozilla Community Participation Guidelines](https://www.mozilla.org/about/governance/policies/participation/).
6 |
7 | ## How to Report
8 | 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.
9 |
10 |
16 |
--------------------------------------------------------------------------------
/Jenkinsfile:
--------------------------------------------------------------------------------
1 | #!groovy
2 |
3 | def syncS3(String bucket, String extra_args='') {
4 | stage ('s3 sync') {
5 | try {
6 | sh "bin/s3-sync.sh ${bucket} ${extra_args}"
7 | } catch(err) {
8 | sh "bin/irc-notify.sh --stage 's3 sync " + env.BRANCH_NAME + "' --status 'failed'"
9 | throw err
10 | }
11 | sh "bin/irc-notify.sh --stage 's3 sync " + env.BRANCH_NAME + "' --status 'shipped'"
12 | }
13 | }
14 |
15 | node {
16 | stage('Prepare') {
17 | checkout scm
18 | }
19 | stage('Deploy') {
20 | syncS3('mdn-dev-178589013767')
21 | }
22 | }
23 |
24 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Mozilla Public License Version 2.0
2 | ==================================
3 |
4 | 1. Definitions
5 | --------------
6 |
7 | 1.1. "Contributor"
8 | means each individual or legal entity that creates, contributes to
9 | the creation of, or owns Covered Software.
10 |
11 | 1.2. "Contributor Version"
12 | means the combination of the Contributions of others (if any) used
13 | by a Contributor and that particular Contributor's Contribution.
14 |
15 | 1.3. "Contribution"
16 | means Covered Software of a particular Contributor.
17 |
18 | 1.4. "Covered Software"
19 | means Source Code Form to which the initial Contributor has attached
20 | the notice in Exhibit A, the Executable Form of such Source Code
21 | Form, and Modifications of such Source Code Form, in each case
22 | including portions thereof.
23 |
24 | 1.5. "Incompatible With Secondary Licenses"
25 | means
26 |
27 | (a) that the initial Contributor has attached the notice described
28 | in Exhibit B to the Covered Software; or
29 |
30 | (b) that the Covered Software was made available under the terms of
31 | version 1.1 or earlier of the License, but not also under the
32 | terms of a Secondary License.
33 |
34 | 1.6. "Executable Form"
35 | means any form of the work other than Source Code Form.
36 |
37 | 1.7. "Larger Work"
38 | means a work that combines Covered Software with other material, in
39 | a separate file or files, that is not Covered Software.
40 |
41 | 1.8. "License"
42 | means this document.
43 |
44 | 1.9. "Licensable"
45 | means having the right to grant, to the maximum extent possible,
46 | whether at the time of the initial grant or subsequently, any and
47 | all of the rights conveyed by this License.
48 |
49 | 1.10. "Modifications"
50 | means any of the following:
51 |
52 | (a) any file in Source Code Form that results from an addition to,
53 | deletion from, or modification of the contents of Covered
54 | Software; or
55 |
56 | (b) any new file in Source Code Form that contains any Covered
57 | Software.
58 |
59 | 1.11. "Patent Claims" of a Contributor
60 | means any patent claim(s), including without limitation, method,
61 | process, and apparatus claims, in any patent Licensable by such
62 | Contributor that would be infringed, but for the grant of the
63 | License, by the making, using, selling, offering for sale, having
64 | made, import, or transfer of either its Contributions or its
65 | Contributor Version.
66 |
67 | 1.12. "Secondary License"
68 | means either the GNU General Public License, Version 2.0, the GNU
69 | Lesser General Public License, Version 2.1, the GNU Affero General
70 | Public License, Version 3.0, or any later versions of those
71 | licenses.
72 |
73 | 1.13. "Source Code Form"
74 | means the form of the work preferred for making modifications.
75 |
76 | 1.14. "You" (or "Your")
77 | means an individual or a legal entity exercising rights under this
78 | License. For legal entities, "You" includes any entity that
79 | controls, is controlled by, or is under common control with You. For
80 | purposes of this definition, "control" means (a) the power, direct
81 | or indirect, to cause the direction or management of such entity,
82 | whether by contract or otherwise, or (b) ownership of more than
83 | fifty percent (50%) of the outstanding shares or beneficial
84 | ownership of such entity.
85 |
86 | 2. License Grants and Conditions
87 | --------------------------------
88 |
89 | 2.1. Grants
90 |
91 | Each Contributor hereby grants You a world-wide, royalty-free,
92 | non-exclusive license:
93 |
94 | (a) under intellectual property rights (other than patent or trademark)
95 | Licensable by such Contributor to use, reproduce, make available,
96 | modify, display, perform, distribute, and otherwise exploit its
97 | Contributions, either on an unmodified basis, with Modifications, or
98 | as part of a Larger Work; and
99 |
100 | (b) under Patent Claims of such Contributor to make, use, sell, offer
101 | for sale, have made, import, and otherwise transfer either its
102 | Contributions or its Contributor Version.
103 |
104 | 2.2. Effective Date
105 |
106 | The licenses granted in Section 2.1 with respect to any Contribution
107 | become effective for each Contribution on the date the Contributor first
108 | distributes such Contribution.
109 |
110 | 2.3. Limitations on Grant Scope
111 |
112 | The licenses granted in this Section 2 are the only rights granted under
113 | this License. No additional rights or licenses will be implied from the
114 | distribution or licensing of Covered Software under this License.
115 | Notwithstanding Section 2.1(b) above, no patent license is granted by a
116 | Contributor:
117 |
118 | (a) for any code that a Contributor has removed from Covered Software;
119 | or
120 |
121 | (b) for infringements caused by: (i) Your and any other third party's
122 | modifications of Covered Software, or (ii) the combination of its
123 | Contributions with other software (except as part of its Contributor
124 | Version); or
125 |
126 | (c) under Patent Claims infringed by Covered Software in the absence of
127 | its Contributions.
128 |
129 | This License does not grant any rights in the trademarks, service marks,
130 | or logos of any Contributor (except as may be necessary to comply with
131 | the notice requirements in Section 3.4).
132 |
133 | 2.4. Subsequent Licenses
134 |
135 | No Contributor makes additional grants as a result of Your choice to
136 | distribute the Covered Software under a subsequent version of this
137 | License (see Section 10.2) or under the terms of a Secondary License (if
138 | permitted under the terms of Section 3.3).
139 |
140 | 2.5. Representation
141 |
142 | Each Contributor represents that the Contributor believes its
143 | Contributions are its original creation(s) or it has sufficient rights
144 | to grant the rights to its Contributions conveyed by this License.
145 |
146 | 2.6. Fair Use
147 |
148 | This License is not intended to limit any rights You have under
149 | applicable copyright doctrines of fair use, fair dealing, or other
150 | equivalents.
151 |
152 | 2.7. Conditions
153 |
154 | Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
155 | in Section 2.1.
156 |
157 | 3. Responsibilities
158 | -------------------
159 |
160 | 3.1. Distribution of Source Form
161 |
162 | All distribution of Covered Software in Source Code Form, including any
163 | Modifications that You create or to which You contribute, must be under
164 | the terms of this License. You must inform recipients that the Source
165 | Code Form of the Covered Software is governed by the terms of this
166 | License, and how they can obtain a copy of this License. You may not
167 | attempt to alter or restrict the recipients' rights in the Source Code
168 | Form.
169 |
170 | 3.2. Distribution of Executable Form
171 |
172 | If You distribute Covered Software in Executable Form then:
173 |
174 | (a) such Covered Software must also be made available in Source Code
175 | Form, as described in Section 3.1, and You must inform recipients of
176 | the Executable Form how they can obtain a copy of such Source Code
177 | Form by reasonable means in a timely manner, at a charge no more
178 | than the cost of distribution to the recipient; and
179 |
180 | (b) You may distribute such Executable Form under the terms of this
181 | License, or sublicense it under different terms, provided that the
182 | license for the Executable Form does not attempt to limit or alter
183 | the recipients' rights in the Source Code Form under this License.
184 |
185 | 3.3. Distribution of a Larger Work
186 |
187 | You may create and distribute a Larger Work under terms of Your choice,
188 | provided that You also comply with the requirements of this License for
189 | the Covered Software. If the Larger Work is a combination of Covered
190 | Software with a work governed by one or more Secondary Licenses, and the
191 | Covered Software is not Incompatible With Secondary Licenses, this
192 | License permits You to additionally distribute such Covered Software
193 | under the terms of such Secondary License(s), so that the recipient of
194 | the Larger Work may, at their option, further distribute the Covered
195 | Software under the terms of either this License or such Secondary
196 | License(s).
197 |
198 | 3.4. Notices
199 |
200 | You may not remove or alter the substance of any license notices
201 | (including copyright notices, patent notices, disclaimers of warranty,
202 | or limitations of liability) contained within the Source Code Form of
203 | the Covered Software, except that You may alter any license notices to
204 | the extent required to remedy known factual inaccuracies.
205 |
206 | 3.5. Application of Additional Terms
207 |
208 | You may choose to offer, and to charge a fee for, warranty, support,
209 | indemnity or liability obligations to one or more recipients of Covered
210 | Software. However, You may do so only on Your own behalf, and not on
211 | behalf of any Contributor. You must make it absolutely clear that any
212 | such warranty, support, indemnity, or liability obligation is offered by
213 | You alone, and You hereby agree to indemnify every Contributor for any
214 | liability incurred by such Contributor as a result of warranty, support,
215 | indemnity or liability terms You offer. You may include additional
216 | disclaimers of warranty and limitations of liability specific to any
217 | jurisdiction.
218 |
219 | 4. Inability to Comply Due to Statute or Regulation
220 | ---------------------------------------------------
221 |
222 | If it is impossible for You to comply with any of the terms of this
223 | License with respect to some or all of the Covered Software due to
224 | statute, judicial order, or regulation then You must: (a) comply with
225 | the terms of this License to the maximum extent possible; and (b)
226 | describe the limitations and the code they affect. Such description must
227 | be placed in a text file included with all distributions of the Covered
228 | Software under this License. Except to the extent prohibited by statute
229 | or regulation, such description must be sufficiently detailed for a
230 | recipient of ordinary skill to be able to understand it.
231 |
232 | 5. Termination
233 | --------------
234 |
235 | 5.1. The rights granted under this License will terminate automatically
236 | if You fail to comply with any of its terms. However, if You become
237 | compliant, then the rights granted under this License from a particular
238 | Contributor are reinstated (a) provisionally, unless and until such
239 | Contributor explicitly and finally terminates Your grants, and (b) on an
240 | ongoing basis, if such Contributor fails to notify You of the
241 | non-compliance by some reasonable means prior to 60 days after You have
242 | come back into compliance. Moreover, Your grants from a particular
243 | Contributor are reinstated on an ongoing basis if such Contributor
244 | notifies You of the non-compliance by some reasonable means, this is the
245 | first time You have received notice of non-compliance with this License
246 | from such Contributor, and You become compliant prior to 30 days after
247 | Your receipt of the notice.
248 |
249 | 5.2. If You initiate litigation against any entity by asserting a patent
250 | infringement claim (excluding declaratory judgment actions,
251 | counter-claims, and cross-claims) alleging that a Contributor Version
252 | directly or indirectly infringes any patent, then the rights granted to
253 | You by any and all Contributors for the Covered Software under Section
254 | 2.1 of this License shall terminate.
255 |
256 | 5.3. In the event of termination under Sections 5.1 or 5.2 above, all
257 | end user license agreements (excluding distributors and resellers) which
258 | have been validly granted by You or Your distributors under this License
259 | prior to termination shall survive termination.
260 |
261 | ************************************************************************
262 | * *
263 | * 6. Disclaimer of Warranty *
264 | * ------------------------- *
265 | * *
266 | * Covered Software is provided under this License on an "as is" *
267 | * basis, without warranty of any kind, either expressed, implied, or *
268 | * statutory, including, without limitation, warranties that the *
269 | * Covered Software is free of defects, merchantable, fit for a *
270 | * particular purpose or non-infringing. The entire risk as to the *
271 | * quality and performance of the Covered Software is with You. *
272 | * Should any Covered Software prove defective in any respect, You *
273 | * (not any Contributor) assume the cost of any necessary servicing, *
274 | * repair, or correction. This disclaimer of warranty constitutes an *
275 | * essential part of this License. No use of any Covered Software is *
276 | * authorized under this License except under this disclaimer. *
277 | * *
278 | ************************************************************************
279 |
280 | ************************************************************************
281 | * *
282 | * 7. Limitation of Liability *
283 | * -------------------------- *
284 | * *
285 | * Under no circumstances and under no legal theory, whether tort *
286 | * (including negligence), contract, or otherwise, shall any *
287 | * Contributor, or anyone who distributes Covered Software as *
288 | * permitted above, be liable to You for any direct, indirect, *
289 | * special, incidental, or consequential damages of any character *
290 | * including, without limitation, damages for lost profits, loss of *
291 | * goodwill, work stoppage, computer failure or malfunction, or any *
292 | * and all other commercial damages or losses, even if such party *
293 | * shall have been informed of the possibility of such damages. This *
294 | * limitation of liability shall not apply to liability for death or *
295 | * personal injury resulting from such party's negligence to the *
296 | * extent applicable law prohibits such limitation. Some *
297 | * jurisdictions do not allow the exclusion or limitation of *
298 | * incidental or consequential damages, so this exclusion and *
299 | * limitation may not apply to You. *
300 | * *
301 | ************************************************************************
302 |
303 | 8. Litigation
304 | -------------
305 |
306 | Any litigation relating to this License may be brought only in the
307 | courts of a jurisdiction where the defendant maintains its principal
308 | place of business and such litigation shall be governed by laws of that
309 | jurisdiction, without reference to its conflict-of-law provisions.
310 | Nothing in this Section shall prevent a party's ability to bring
311 | cross-claims or counter-claims.
312 |
313 | 9. Miscellaneous
314 | ----------------
315 |
316 | This License represents the complete agreement concerning the subject
317 | matter hereof. If any provision of this License is held to be
318 | unenforceable, such provision shall be reformed only to the extent
319 | necessary to make it enforceable. Any law or regulation which provides
320 | that the language of a contract shall be construed against the drafter
321 | shall not be used to construe this License against a Contributor.
322 |
323 | 10. Versions of the License
324 | ---------------------------
325 |
326 | 10.1. New Versions
327 |
328 | Mozilla Foundation is the license steward. Except as provided in Section
329 | 10.3, no one other than the license steward has the right to modify or
330 | publish new versions of this License. Each version will be given a
331 | distinguishing version number.
332 |
333 | 10.2. Effect of New Versions
334 |
335 | You may distribute the Covered Software under the terms of the version
336 | of the License under which You originally received the Covered Software,
337 | or under the terms of any subsequent version published by the license
338 | steward.
339 |
340 | 10.3. Modified Versions
341 |
342 | If you create software not governed by this License, and you want to
343 | create a new license for such software, you may create and use a
344 | modified version of this License if you rename the license and remove
345 | any references to the name of the license steward (except to note that
346 | such modified license differs from this License).
347 |
348 | 10.4. Distributing Source Code Form that is Incompatible With Secondary
349 | Licenses
350 |
351 | If You choose to distribute Source Code Form that is Incompatible With
352 | Secondary Licenses under the terms of this version of the License, the
353 | notice described in Exhibit B of this License must be attached.
354 |
355 | Exhibit A - Source Code Form License Notice
356 | -------------------------------------------
357 |
358 | This Source Code Form is subject to the terms of the Mozilla Public
359 | License, v. 2.0. If a copy of the MPL was not distributed with this
360 | file, You can obtain one at http://mozilla.org/MPL/2.0/.
361 |
362 | If it is not possible or desirable to put the notice in a particular
363 | file, then You may include the notice in a location (such as a LICENSE
364 | file in a relevant directory) where a recipient would be likely to look
365 | for such a notice.
366 |
367 | You may add additional accurate notices of copyright ownership.
368 |
369 | Exhibit B - "Incompatible With Secondary Licenses" Notice
370 | ---------------------------------------------------------
371 |
372 | This Source Code Form is "Incompatible With Secondary Licenses", as
373 | defined by the Mozilla Public License, v. 2.0.
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # mdn.dev
2 |
3 | The home of mdn.dev
4 |
--------------------------------------------------------------------------------
/bin/irc-notify.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | set -eo pipefail
3 |
4 | # Required environment variables if using --stage:
5 | # BRANCH_NAME, BUILD_NUMBER
6 |
7 | # defaults and constants
8 | NICK="mdn.devbot"
9 | CHANNEL="#mdndev"
10 | SERVER="irc.mozilla.org:6697"
11 | # colors and styles: values from the following links
12 | # http://www.mirc.com/colors.html
13 | # http://stackoverflow.com/a/13382032
14 | RED=$'\x034'
15 | YELLOW=$'\x038'
16 | GREEN=$'\x039'
17 | BLUE=$'\x0311'
18 | BOLD=$'\x02'
19 | NORMAL=$'\x0F'
20 |
21 | # parse cli args
22 | while [[ $# -gt 1 ]]; do
23 | key="$1"
24 | case $key in
25 | --stage)
26 | STAGE="$2"
27 | shift # past argument
28 | ;;
29 | --status)
30 | STATUS="$2"
31 | shift # past argument
32 | ;;
33 | -m|--message)
34 | MESSAGE="$2"
35 | shift # past argument
36 | ;;
37 | --irc_nick)
38 | NICK="$2"
39 | shift # past argument
40 | ;;
41 | --irc_server)
42 | SERVER="$2"
43 | shift # past argument
44 | ;;
45 | --irc_channel)
46 | CHANNEL="$2"
47 | shift # past argument
48 | ;;
49 | esac
50 | shift # past argument or value
51 | done
52 |
53 | if [[ -n "$STATUS" ]]; then
54 | STATUS=$(echo "$STATUS" | tr '[:lower:]' '[:upper:]')
55 | case "$STATUS" in
56 | 'SUCCESS')
57 | STATUS_COLOR="🎉 ${BOLD}${GREEN}"
58 | ;;
59 | 'SHIPPED')
60 | STATUS_COLOR="🚢 ${BOLD}${GREEN}"
61 | ;;
62 | 'WARNING')
63 | STATUS_COLOR="⚠️ ${BOLD}${YELLOW}"
64 | ;;
65 | 'FAILURE')
66 | STATUS_COLOR="🚨 ${BOLD}${RED}"
67 | ;;
68 | *)
69 | STATUS_COLOR="✨ $BLUE"
70 | ;;
71 | esac
72 | STATUS="${STATUS_COLOR}${STATUS}${NORMAL}: "
73 | fi
74 |
75 | if [[ -n "$STAGE" ]]; then
76 | MESSAGE="${STATUS}${STAGE}:"
77 | MESSAGE="$MESSAGE Branch ${BOLD}${BRANCH_NAME}${NORMAL} build #${BUILD_NUMBER}: ${RUN_DISPLAY_URL}"
78 | elif [[ -n "$MESSAGE" ]]; then
79 | MESSAGE="${STATUS}${MESSAGE}"
80 | else
81 | echo "Missing required arguments"
82 | echo
83 | echo "Usage: irc-notify.sh [--stage STAGE]|[-m MESSAGE]"
84 | echo "Optional args: --status, --irc_nick, --irc_server, --irc_channel"
85 | exit 1
86 | fi
87 |
88 | if [[ -n "$BUILD_NUMBER" ]]; then
89 | NICK="${NICK}-${BUILD_NUMBER}"
90 | fi
91 |
92 | (
93 | echo "NICK ${NICK}"
94 | echo "USER ${NICK} 8 * : ${NICK}"
95 | sleep 5
96 | echo "JOIN ${CHANNEL}"
97 | echo "NOTICE ${CHANNEL} :${MESSAGE}"
98 | echo "QUIT"
99 | ) | openssl s_client -connect "$SERVER" > /dev/null 2>&1
100 |
--------------------------------------------------------------------------------
/bin/s3-sync.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 |
3 | if [[ -z "$1" ]]; then
4 | echo "Bucket name required"
5 | exit 1
6 | fi
7 |
8 | CACHE="--cache-control max-age=2629800" # 1 month
9 | ARGS="--acl public-read --delete ${@:2}"
10 |
11 | echo "Copying static folder to $1"
12 | aws s3 sync static/ s3://$1/ ${CACHE} ${ARGS}
13 |
--------------------------------------------------------------------------------
/build-utils/loadPresets.js:
--------------------------------------------------------------------------------
1 | const webpackMerge = require("webpack-merge");
2 |
3 | const applyPresets = (env = { presets: [] }) => {
4 | let presets = env.presets || [];
5 | // only split if the array has more than one item
6 | if (presets.length) {
7 | presets = presets.split(",");
8 | }
9 | /** @type {string[]} */
10 | const mergedPresets = [].concat(...[presets]);
11 | const mergedConfigs = mergedPresets.map(presetName =>
12 | require(`./presets/webpack.${presetName}`)(env)
13 | );
14 |
15 | return webpackMerge({}, ...mergedConfigs);
16 | };
17 |
18 | module.exports = applyPresets;
19 |
--------------------------------------------------------------------------------
/build-utils/presets/webpack.analyze.js:
--------------------------------------------------------------------------------
1 | const WebpackBundleAnalyzer = require("webpack-bundle-analyzer")
2 | .BundleAnalyzerPlugin;
3 |
4 | module.exports = () => ({
5 | plugins: [new WebpackBundleAnalyzer()]
6 | });
7 |
--------------------------------------------------------------------------------
/build-utils/presets/webpack.compress.js:
--------------------------------------------------------------------------------
1 | const CompressionWebpackPlugin = require("compression-webpack-plugin");
2 |
3 | module.exports = () => ({
4 | plugins: [new CompressionWebpackPlugin()]
5 | });
6 |
--------------------------------------------------------------------------------
/build-utils/presets/webpack.sass.js:
--------------------------------------------------------------------------------
1 | module.exports = () => ({
2 | module: {
3 | rules: [
4 | {
5 | test: /\.scss$/,
6 | use: ["style-loader", "css-loader", "sass-loader"]
7 | }
8 | ]
9 | }
10 | });
11 |
--------------------------------------------------------------------------------
/build-utils/webpack.development.js:
--------------------------------------------------------------------------------
1 | const webpack = require("webpack");
2 |
3 | module.exports = () => ({
4 | devtool: "cheap-eval-source-map",
5 | devServer: {
6 | hot: true,
7 | publicPath: "/dist/",
8 | writeToDisk: true
9 | },
10 | entry: [
11 | "react-hot-loader/patch",
12 | "webpack-dev-server/client?http://localhost:8080",
13 | "webpack/hot/only-dev-server",
14 | "./src/App.js"
15 | ],
16 | output: {
17 | filename: "bundle.js",
18 | publicPath: "/dist/"
19 | },
20 | plugins: [
21 | new webpack.HotModuleReplacementPlugin(),
22 | new webpack.NamedModulesPlugin()
23 | ]
24 | });
25 |
--------------------------------------------------------------------------------
/build-utils/webpack.production.js:
--------------------------------------------------------------------------------
1 | const path = require("path");
2 | const CopyWebpackPlugin = require("copy-webpack-plugin");
3 | const MiniCssExtractPlugin = require("mini-css-extract-plugin");
4 |
5 | module.exports = () => ({
6 | devtool: "nosources-source-map",
7 | entry: ["./src/App.js"],
8 | output: {
9 | path: path.join(__dirname, "../static"),
10 | filename: "[name].[hash].js"
11 | },
12 | module: {
13 | rules: [
14 | {
15 | test: /\.css$/,
16 | use: [MiniCssExtractPlugin.loader, "css-loader"]
17 | },
18 | {
19 | test: /\.scss$/,
20 | use: [MiniCssExtractPlugin.loader, "css-loader", "sass-loader"]
21 | }
22 | ]
23 | },
24 | plugins: [
25 | new MiniCssExtractPlugin(),
26 | new CopyWebpackPlugin([{ from: "./src/media/favicon144.png" }])
27 | ]
28 | });
29 |
--------------------------------------------------------------------------------
/contribute.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "mdn.dev",
3 | "description": "The home of mdn.dev",
4 | "repository": {
5 | "url": "https://github.com/mdn/mdn.dev",
6 | "license": "MPL-2.0"
7 | },
8 | "participate": {
9 | "home": "https://github.com/mdn/mdn.dev",
10 | "docs": "https://github.com/mdn/mdn.dev",
11 | "irc": "irc://irc.mozilla.org/#mdndev",
12 | "irc-contacts": ["espressive", "jwhitlock", "rjohnson", "djf"]
13 | },
14 | "bugs": {
15 | "list": "https://github.com/mdn/mdn.dev/issues",
16 | "report": "https://github.com/mdn/mdn.dev/issues/new"
17 | },
18 | "urls": {
19 | "prod": "https://mdn.dev"
20 | },
21 | "keywords": ["reactjs", "javascript", "sass", "webpack", "html"]
22 | }
23 |
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "mdn-dev",
3 | "version": "1.0.0",
4 | "description": "The home of mdn.dev",
5 | "main": "src/App.js",
6 | "scripts": {
7 | "webpack-dev-server": "webpack-dev-server",
8 | "webpack": "webpack",
9 | "debug": "node --inspect --inspect-brk ./node_modules/webpack/bin/webpack.js",
10 | "prod": "npm run webpack -- --env.mode production",
11 | "prod:compress": "npm run prod -- --env.presets compress",
12 | "prod:analyze": "npm run prod -- --env.presets analyze",
13 | "prod:compress-analyze": "npm run prod -- --env.presets compress,analyze",
14 | "dev": "npm run webpack-dev-server -- --env.mode development",
15 | "test": "jest",
16 | "flow": "flow"
17 | },
18 | "keywords": [
19 | "mdn",
20 | "react",
21 | "javascript",
22 | "sass",
23 | "html",
24 | "webpack"
25 | ],
26 | "author": "Mozilla Web Docs",
27 | "license": "MPL-2.0",
28 | "devDependencies": {
29 | "@babel/core": "7.2.2",
30 | "@babel/plugin-proposal-class-properties": "7.3.0",
31 | "@babel/plugin-syntax-dynamic-import": "7.2.0",
32 | "@babel/preset-env": "7.3.1",
33 | "@babel/preset-flow": "7.0.0",
34 | "@babel/preset-react": "7.0.0",
35 | "@storybook/react": "4.1.11",
36 | "babel-eslint": "10.0.1",
37 | "babel-loader": "8.0.5",
38 | "compression-webpack-plugin": "2.0.0",
39 | "copy-webpack-plugin": "4.6.0",
40 | "css-loader": "2.1.0",
41 | "eslint": "5.12.1",
42 | "eslint-config-prettier": "3.6.0",
43 | "eslint-loader": "2.1.1",
44 | "eslint-plugin-flowtype": "3.2.1",
45 | "eslint-plugin-import": "2.15.0",
46 | "eslint-plugin-jsx-a11y": "6.2.0",
47 | "eslint-plugin-prettier": "3.0.1",
48 | "eslint-plugin-react": "7.12.4",
49 | "file-loader": "3.0.1",
50 | "html-webpack-plugin": "3.2.0",
51 | "jest": "24.0.0",
52 | "mini-css-extract-plugin": "0.5.0",
53 | "node-sass": "4.11.0",
54 | "prettier": "1.16.1",
55 | "react-test-renderer": "16.7.0",
56 | "sass-loader": "7.1.0",
57 | "style-loader": "0.23.1",
58 | "svgo": "1.1.1",
59 | "svgo-loader": "2.2.0",
60 | "url-loader": "1.1.2",
61 | "webpack": "4.29.0",
62 | "webpack-bundle-analyzer": "3.3.2",
63 | "webpack-cli": "3.2.1",
64 | "webpack-dev-server": "3.1.14",
65 | "webpack-merge": "4.2.1"
66 | },
67 | "dependencies": {
68 | "flow-bin": "0.92.1",
69 | "react": "16.7.0",
70 | "react-dom": "16.7.0",
71 | "react-hot-loader": "4.6.5"
72 | }
73 | }
74 |
--------------------------------------------------------------------------------
/src/.DS_Store:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/mdn/mdn.dev-2019/d410732b7ec587c68e00c8d207b097ffdab0b380/src/.DS_Store
--------------------------------------------------------------------------------
/src/App.js:
--------------------------------------------------------------------------------
1 | import React from "react";
2 | import { render } from "react-dom";
3 |
4 | import Header from "./components/Header";
5 | import Content from "./components/Content";
6 | import Footer from "./components/Footer";
7 |
8 | import "./style/main.scss";
9 |
10 | class App extends React.Component {
11 | render() {
12 | return (
13 |
8 | MDN Web Docs (formerly
9 | MDN) was first launched by Mozilla around 2005,
10 | and has grown from humble beginnings to being one of the most popular
11 | web development resources on the web today. It now boasts over 13
12 | million page views per month, a strong ecosystem of documentation and
13 | data, and a lively community of contributors. It is used every day by
14 | professional web developers to do their jobs, and by students to learn
15 | new skills.
16 |
8 | Our source code is freely available to contribute to, and we’d love you
9 | to help us improve our platform, data, and content!
10 |
11 |
12 | For our data and platform code, you can find instructions on the
13 | relevant repos. Feel free to get up and running, and submit pull
14 | requests.
15 |
16 |
17 | You can edit any of our content pages by logging in and then pressing
18 | the edit button. MDN Web Docs uses GitHub login.If you’ve got a GitHub
19 | account, you can get an MDN account by{" "}
20 |
21 | following these instructions
22 |
23 | .
24 |
25 |
26 | You can find information on how to contribute to MDN content in our
27 | getting started guide.{" "}
28 |
32 | Start Contributing!
33 |
34 |
8 | We have a number of repos available at the{" "}
9 | github.com/mdn org. Many of these
10 | repos contain examples associated with various parts of the MDN
11 | documentation, but we also have some key repos that store structured
12 | data related to our various functions. These are listed below.
13 |
14 |
15 |
16 | data — this repo contains
17 | data related to web technology syntax, mainly CSS. It is used to
18 | generate formal syntax and information boxes on CSS reference pages,
19 | and is also used by other projects such as VSCode to generate
20 | in-editor help information.
21 |
22 |
23 |
24 | browser-compat-data
25 | {" "}
26 | — this contains extensive browser compatibility data for all web
27 | technology features. This is used to generate the Browser
28 | compatibility tables seen on MDN Web Docs references pages, but is
29 | also used to generate contextual compat information in projects such
30 | as VScode and webhint.io
31 |
32 |
33 |
34 | interactive-examples
35 | {" "}
36 | — this contains HTML, CSS, and JavaScript code examples, which along
37 | with the BoB renderer are
38 | used to generate the interactive examples seen at the top of HTML,
39 | CSS, and JavaScript reference pages. So for example:
40 |
8 | The platform that powers MDN Web Docs is called Kuma, based on Django,
9 | and is stored in the{" "}
10 | github.com/mozilla/kuma{" "}
11 | repo.
12 |
13 |
14 | Kuma has a macro system based on Node.js called KumaScript, which is
15 | used to implement sidebars and other common features on MDN Web Docs
16 | pages.
17 |