From dcf483a139b84c590028a9a845a5bd0c739afdef Mon Sep 17 00:00:00 2001 From: Dipika Bhattacharya Date: Tue, 19 Jul 2022 18:25:20 +0200 Subject: [PATCH] Move new contrib docs (#18041) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Move new contrib docs * underscores * renaming * removing redirect about * creating moving * experimental * does belong * editorial * code style guide * writing style guide * howto and seo * related_criteria for inclusion * file rename, link update * Updated Syntax for fetch-related pages (#17914) * Updated Syntax * port changes Co-authored-by: Joshua Chen * Fix wrong example quote (#18458) * Unshorten code in method definition (#18457) * fixes https://github.com/mdn/content/issues/18444 * Update index.md Co-authored-by: Joshua Chen * fix: correct the language of code examples (#18455) * Add `const` var declaration to FileSystemFileHandle sample code (#17930) * Add `const` var declaration * Update index.md * Update index.md Co-authored-by: Joshua Chen * Update dom-examples links (#18462) * MediaRecorder: Update dom-examples links (#18464) * Update dom-example link (#18465) * update a broken link (#18466) * remove a broken link (#18467) * Update a broken link (#18468) * Fixes broken live sample (#18456) * Intl.NumberFormat - flyby fixes (#18258) * Fix `channelCount` semantics in `MediaStreamAudioSourceNode`. (#18472) * Fix `channelCount` semantics. This sparked confusion, e.g. in https://github.com/WebAudio/web-audio-api/issues/2496. Source: I am this specification's editor. * Fix markup. * Fix parenthesis * Fix `channelCount` semantics. (#18473) * Fix `channelCount` semantics. This sparked confusion, e.g. in https://github.com/WebAudio/web-audio-api/issues/2496. Source: I am this specification's editor. * Fix markup. * Fix parenthesis * Remove a few pointless references to internal slots (#18461) * Remove a few pointless references to internal slots * Update index.md * Apply suggestions from code review Co-authored-by: Jean-Yves Perrier * simplify description Co-authored-by: Jean-Yves Perrier * Fix syntax errors (#18475) * Fix syntax error Reported in https://github.com/orgs/mdn/discussions/158 (PR11) The macro just prints `Deprected` on the next line. * Fix in blobbuilder * Remove js annotation for webidl blocks Co-authored-by: Jean-Yves Perrier * fix: syntax errors in JS example sections (v5) (#18442) * syntax fixes * fix remaining syntax errors * Adapt syntax box Co-authored-by: Jean-Yves Perrier * Use diff instead of js to mark a diff block (#18477) * Update good vs bad example * fix a typo * marking it as diff * Bump @mdn/yari from 1.10.0 to 1.10.2 (#18479) * Correct a few usage of internal methods (#18476) * Change 'nodes' link to link directly to DOM nodes (#18480) The link to DOM 'nodes' currently links to the 'nodes' glossary page. I changed the link to DOM 'nodes' to directly link to the DOM nodes page. * Shorten Global object glossary entry (#18474) * FF103 Native Error types are serializable (#18384) * FF104 Native Error types are serializable * Fix error - this is in FF103, not 104 * Update files/en-us/web/api/web_workers_api/structured_clone_algorithm/index.md Co-authored-by: Joshua Chen * Remove stack info from release note * Update files/en-us/mozilla/firefox/releases/103/index.md Co-authored-by: Joshua Chen * Demix invalid event from GlobalEventHandlers (#18451) * Demix slotchange from GlobalEventHandlers (#18225) * fix: various typos (#18483) * Fix typo (#18486) Remove stray 'a' in "contain a separator characters like the following" -> "contain separator characters like the following" * Fix link text (#18488) * Add missing period (#18487) * fix broken link (#18490) * Remove continuity descriptions from `steps(...)` (#18482) As per the spec (https://drafts.csswg.org/css-easing/#step-easing-functions), Figure 5, all step functions are right-continuous (i.e. You'd encounter solid dots approaching discontinuity from the right side). The `direction` keyword should strictly describe when the jumps (i.e. discontinuities) happen. * OpenType guide: font-variant-position is not mutually exclusive with / (#18459) Thank you! * Fix links for other references (#18501) * update a broken link (#18500) * Comment out ellipsis in code blocks (#18496) * Comment out ellipsis in code blocks (#18498) * Comment out ellipsis in code blocks (#18497) * Elaborate on destructuring assignment (#18495) * Elaborate on destructuring assignment * add headings * Mark kumascript code blocks js -> plain (#18493) * remove a broken link (#18499) * remove a broken link * Apply suggestions from code review Co-authored-by: Jean-Yves Perrier Co-authored-by: Jean-Yves Perrier * Demix pointer capture events from GlobalEventHandlers (#18450) * Demix pointer capture events from GlobalEventHandlers * Update files/en-us/web/api/element/lostpointercapture_event/index.md Co-authored-by: Jean-Yves Perrier * Add event properties section (still seems redundant...) * Add additional event properties section Co-authored-by: Jean-Yves Perrier * Improvements to a few Number APIs (#18502) * Minor spread syntax rewrite (#18503) * Minor spread syntax rewrite * Update files/en-us/web/javascript/reference/operators/spread_syntax/index.md Co-authored-by: Jean-Yves Perrier Co-authored-by: Jean-Yves Perrier * Window.open() rework (#18118) * first pass linting: remove xref macros, fix examples, fix code words * 2nd pass: remove broken/insecure links, fix remaining typos * Third pass - rework * fix flaws * Apply 1st set of suggestions Co-authored-by: Jean-Yves Perrier * Taking @teoli2003 review into account Co-authored-by: Jean-Yves Perrier * Fix broken block code in `Bracket notation` section (#18507) Add three missing backticks at ending of block code * Fix typo (#18508) * Fix missing parenthesis (#18509) * Mention string iteration goes by Unicode characters (#18504) * Mention string iteration goes by Unicode characters * add a flag example * Fix "repository of wavetables" text's broken link (#18510) * Add TBD content to files frontmatter and macros * Add TBD content to more empty files * TBD content * Add missing front matter data to files * Fix slug * Fix slugs * fix remaining writing guideline docs Co-authored-by: Ruth John Co-authored-by: Prajwal Borkar Co-authored-by: Joshua Chen Co-authored-by: Davide Briano <36935593+buondevid@users.noreply.github.com> Co-authored-by: Xavi Lee Co-authored-by: A1lo Co-authored-by: Zhang Yi Jiang Co-authored-by: Onkar Ruikar <87750369+OnkarRuikar@users.noreply.github.com> Co-authored-by: Hamish Willee Co-authored-by: Paul Adenot Co-authored-by: Jean-Yves Perrier Co-authored-by: Lion Ralfs Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: simonvarey <88859869+simonvarey@users.noreply.github.com> Co-authored-by: Queen Vinyl Da.i'gyu-Kazotetsu Co-authored-by: Nick Schonning Co-authored-by: kokke Co-authored-by: de-oz <101826623+de-oz@users.noreply.github.com> Co-authored-by: Christopher Dignam Co-authored-by: dshin-moz <102040459+dshin-moz@users.noreply.github.com> Co-authored-by: J.Β S.Β Choi Co-authored-by: Masahiro FUJIMOTO Co-authored-by: SphinxKnight Co-authored-by: Minh-Thuan Nguyen Co-authored-by: Remco van 't Veer Co-authored-by: Jeremy Pearson Co-authored-by: Schalk Neethling --- files/en-us/_redirects.txt | 105 ++- files/en-us/_wikihistory.json | 712 ++++-------------- files/en-us/glossary/global_object/index.md | 45 +- files/en-us/glossary/shadow_tree/index.md | 2 +- .../silly_story_generator/index.md | 2 +- .../learn/javascript/objects/basics/index.md | 3 +- .../angular_getting_started/index.md | 8 +- files/en-us/mdn/about/index.md | 67 -- .../howto/create_and_edit_pages/index.md | 39 - .../contribute/howto/write_for_seo/index.md | 63 -- .../guidelines/code_guidelines/css/index.md | 274 ------- .../code_guidelines/general/index.md | 168 ----- .../guidelines/code_guidelines/html/index.md | 190 ----- .../mdn/guidelines/code_guidelines/index.md | 55 -- .../code_guidelines/javascript/index.md | 549 -------------- .../guidelines/code_guidelines/shell/index.md | 35 - .../conventions_definitions/index.md | 227 ------ .../does_this_belong_on_mdn/index.md | 84 --- files/en-us/mdn/guidelines/editorial/index.md | 40 - .../guidelines/writing_style_guide/index.md | 572 -------------- .../mdn/structures/live_samples/index.md | 4 +- files/en-us/mdn/structures/macros/index.md | 2 +- .../css_selector_page_template/index.md | 1 + files/en-us/mdn/tools/kumascript/index.md | 6 +- .../attrib_copyright_license/index.md | 66 ++ .../creating_moving_deleting/index.md | 165 ++++ .../experimental_deprecated_obsolete/index.md | 108 +++ .../howto/document_a_css_property/index.md | 3 +- .../howto/document_an_http_header/index.md | 3 +- .../howto/document_web_errors/index.md | 3 +- .../mdn/writing_guidelines/howto/index.md | 16 + .../howto/tag/index.md | 3 +- .../index.md | 3 +- .../write_an_api_reference/apiref-links.png | Bin .../howto/write_an_api_reference/index.md | 3 +- .../index.md | 607 +++++++++++++++ .../write_an_api_reference/sidebars/index.md | 4 +- files/en-us/mdn/writing_guidelines/index.md | 58 ++ .../page_structure/code_examples/index.md | 195 +++++ .../page_structure/frontmatter/index.md | 11 + .../page_structure/images_media/index.md | 178 +++++ .../page_structure/index.md | 48 ++ .../page_structure/macros/index.md | 11 + .../page_structure/markdown/index.md | 498 ++++++++++++ .../page_types/api/apiref-links.png | Bin 0 -> 6176 bytes .../page_structure/page_types/api/index.md | 406 ++++++++++ .../index.md | 5 +- .../page_types/api/sidebars/index.md | 141 ++++ .../page_structure/page_types/css/index.md | 11 + .../page_types/css/property/index.md | 34 + .../page_types/glossary/index.md | 82 ++ .../page_structure/page_types/html/index.md | 11 + .../page_structure/page_types/http/index.md | 67 ++ .../page_types/javascript/errors/index.md | 51 ++ .../page_types/javascript/index.md | 11 + .../page_structure/page_types/learn/index.md | 11 + .../page_structure/updating_json/index.md | 124 +++ .../research_technology/index.md | 123 +++ .../criteria_for_inclusion/index.md | 182 +++++ .../what_we_write/inclusion_criteria/index.md | 182 +++++ .../writing_guidelines/what_we_write/index.md | 136 ++++ .../code_style_guide/css/index.md | 223 ++++++ .../code_style_guide/html/index.md | 163 ++++ .../code_style_guide/index.md | 206 +++++ .../code_style_guide/javascript/index.md | 483 ++++++++++++ .../code_style_guide/shell/index.md | 31 + .../writing_style_guide/index.md | 603 +++++++++++++++ .../mozilla/firefox/releases/103/index.md | 7 + .../mozilla/firefox/releases/93/index.md | 2 +- .../related/criteria_for_inclusion/index.md | 56 -- .../related/process_for_selection/index.md | 51 -- .../en-us/related/project_guidelines/index.md | 124 --- .../aria/roles/checkbox_role/index.md | 2 +- .../information_for_web_authors/index.md | 2 +- files/en-us/web/api/animation/finish/index.md | 10 +- .../api/audiobuffersourcenode/buffer/index.md | 1 + files/en-us/web/api/audionode/index.md | 2 + .../en-us/web/api/audiotrack/enabled/index.md | 4 +- .../audioworkletprocessor/index.md | 2 +- .../attestationobject/index.md | 2 +- .../gettransports/index.md | 2 +- .../authenticatorattestationresponse/index.md | 2 +- .../web/api/authenticatorresponse/index.md | 2 +- .../api/backgroundfetchmanager/get/index.md | 2 +- .../updateui/index.md | 9 +- .../web/api/barcodedetector/detect/index.md | 2 +- .../api/baseaudiocontext/samplerate/index.md | 2 +- files/en-us/web/api/blobbuilder/index.md | 8 +- .../index.md | 5 +- .../en-us/web/api/cachestorage/open/index.md | 1 + .../fillstyle/index.md | 4 +- .../strokestyle/index.md | 6 +- .../using_channel_messaging/index.md | 2 +- files/en-us/web/api/clipboarditem/index.md | 2 +- files/en-us/web/api/console/debug/index.md | 2 +- files/en-us/web/api/console/error/index.md | 2 +- files/en-us/web/api/console/info/index.md | 2 +- files/en-us/web/api/console/log/index.md | 2 +- files/en-us/web/api/console/warn/index.md | 2 +- files/en-us/web/api/css/paintworklet/index.md | 8 +- .../web/api/cssnamespacerule/prefix/index.md | 4 +- .../en-us/web/api/customstateset/add/index.md | 9 +- files/en-us/web/api/customstateset/index.md | 16 +- .../web/api/datatransfer/setdata/index.md | 2 +- .../api/datatransfer/setdragimage/index.md | 2 +- .../en-us/web/api/datatransfer/types/index.md | 2 +- .../message_event/index.md | 2 +- .../document/gotpointercapture_event/index.md | 94 --- .../lostpointercapture_event/index.md | 66 +- .../api/document/querycommandstate/index.md | 2 +- files/en-us/web/api/document/title/index.md | 2 +- .../how_to_create_a_dom_tree/index.md | 2 +- .../en-us/web/api/dompoint/dompoint/index.md | 2 +- files/en-us/web/api/dompoint/index.md | 8 +- files/en-us/web/api/dompointreadonly/index.md | 8 +- .../element/fullscreenchange_event/index.md | 2 +- .../web/api/element/getattribute/index.md | 4 +- .../element/gotpointercapture_event/index.md | 109 +++ .../element/lostpointercapture_event/index.md | 111 +++ files/en-us/web/api/element/mszoomto/index.md | 6 +- .../en-us/web/api/element/shadowroot/index.md | 18 +- .../api/elementinternals/ariaatomic/index.md | 10 +- .../web/api/filesystemfilehandle/index.md | 30 +- .../web/api/globaleventhandlers/index.md | 10 +- .../ongotpointercapture/index.md | 61 -- .../globaleventhandlers/oninvalid/index.md | 95 --- .../onlostpointercapture/index.md | 61 -- .../globaleventhandlers/onslotchange/index.md | 62 -- .../web/api/history_api/example/index.md | 2 +- .../web/api/htmlcanvaselement/toblob/index.md | 2 +- .../gotpointercapture_event/index.md | 94 --- .../lostpointercapture_event/index.md | 99 --- .../htmlinputelement/invalid_event/index.md | 35 +- .../en-us/web/api/idbkeyrange/bound/index.md | 2 +- files/en-us/web/api/idbkeyrange/index.md | 2 +- .../en-us/web/api/idbkeyrange/lower/index.md | 2 +- .../web/api/idbkeyrange/lowerbound/index.md | 2 +- files/en-us/web/api/idbkeyrange/only/index.md | 2 +- .../en-us/web/api/idbkeyrange/upper/index.md | 2 +- .../web/api/idbkeyrange/upperbound/index.md | 2 +- .../transferfromimagebitmap/index.md | 2 +- .../api/mediaelementaudiosourcenode/index.md | 5 +- .../dataavailable_event/index.md | 2 +- files/en-us/web/api/mediarecorder/index.md | 2 +- .../api/mediarecorder/mediarecorder/index.md | 2 +- .../web/api/mediarecorder/mimetype/index.md | 2 +- .../web/api/mediarecorder/pause/index.md | 2 +- .../api/mediarecorder/pause_event/index.md | 2 +- .../api/mediarecorder/requestdata/index.md | 2 +- .../web/api/mediarecorder/resume/index.md | 2 +- .../api/mediarecorder/resume_event/index.md | 2 +- .../web/api/mediarecorder/start/index.md | 2 +- .../api/mediarecorder/start_event/index.md | 2 +- .../web/api/mediarecorder/state/index.md | 2 +- .../en-us/web/api/mediarecorder/stop/index.md | 2 +- .../web/api/mediarecorder/stop_event/index.md | 2 +- .../web/api/mediarecorder/stream/index.md | 2 +- .../api/mediarecorder/warning_event/index.md | 2 +- .../index.md | 2 +- .../api/mediastreamaudiosourcenode/index.md | 5 +- .../offscreencanvas/converttoblob/index.md | 2 +- files/en-us/web/api/offscreencanvas/index.md | 8 +- .../transfertoimagebitmap/index.md | 2 +- .../payerdetailchange_event/index.md | 4 +- .../api/performanceentry/duration/index.md | 12 +- .../web/api/performanceentry/name/index.md | 12 +- .../api/performanceentry/starttime/index.md | 12 +- .../web/api/performanceentry/tojson/index.md | 12 +- .../readablestreambyobreader/read/index.md | 2 +- files/en-us/web/api/request/clone/index.md | 4 +- .../web/api/request/credentials/index.md | 4 +- .../web/api/request/destination/index.md | 4 +- files/en-us/web/api/request/headers/index.md | 4 +- .../en-us/web/api/request/integrity/index.md | 4 +- files/en-us/web/api/request/method/index.md | 4 +- files/en-us/web/api/request/mode/index.md | 4 +- files/en-us/web/api/request/priority/index.md | 4 +- files/en-us/web/api/request/redirect/index.md | 4 +- files/en-us/web/api/request/referrer/index.md | 4 +- .../web/api/request/referrerpolicy/index.md | 4 +- files/en-us/web/api/request/request/index.md | 76 +- files/en-us/web/api/request/url/index.md | 4 +- .../web/api/response/arraybuffer/index.md | 31 +- files/en-us/web/api/response/blob/index.md | 14 +- .../en-us/web/api/response/bodyused/index.md | 14 +- files/en-us/web/api/response/clone/index.md | 18 +- files/en-us/web/api/response/headers/index.md | 10 +- files/en-us/web/api/response/ok/index.md | 6 +- .../en-us/web/api/response/response/index.md | 6 +- files/en-us/web/api/response/status/index.md | 10 +- .../web/api/response/statustext/index.md | 10 +- files/en-us/web/api/response/text/index.md | 22 +- files/en-us/web/api/response/type/index.md | 10 +- files/en-us/web/api/response/url/index.md | 12 +- files/en-us/web/api/rtcdtlstransport/index.md | 2 +- .../addicecandidate/index.md | 2 +- .../api/rtcpeerconnection/addtrack/index.md | 6 +- .../connectionstate/index.md | 2 +- .../connectionstatechange_event/index.md | 6 +- .../api/rtcpeerconnection/getstats/index.md | 2 +- .../rtcpeerconnection/peeridentity/index.md | 2 +- .../en-us/web/api/screen/orientation/index.md | 4 +- files/en-us/web/api/sensor_apis/index.md | 4 +- files/en-us/web/api/serialport/index.md | 4 +- .../web/api/serialport/readable/index.md | 4 +- .../using_service_workers/index.md | 4 +- .../message_event/index.md | 2 +- .../startmessages/index.md | 4 +- .../fetch_event/index.md | 4 +- .../web/api/serviceworkerglobalscope/index.md | 2 +- files/en-us/web/api/setinterval/index.md | 4 +- files/en-us/web/api/settimeout/index.md | 2 +- .../web/api/shadowroot/onslotchange/index.md | 2 +- .../en-us/web/api/storage_access_api/index.md | 2 +- .../web/api/storage_access_api/using/index.md | 2 +- .../web/api/storagemanager/persist/index.md | 2 +- .../web/api/storagemanager/persisted/index.md | 2 +- .../using_readable_byte_streams/index.md | 36 +- .../using_readable_streams/index.md | 4 +- .../stylepropertymapreadonly/foreach/index.md | 14 +- .../web/api/stylesheet/disabled/index.md | 4 +- files/en-us/web/api/stylesheetlist/index.md | 2 +- .../web/api/subtlecrypto/derivebits/index.md | 4 +- files/en-us/web/api/touch/radiusx/index.md | 2 +- .../api/visualviewport/resize_event/index.md | 4 +- .../api/visualviewport/scroll_event/index.md | 4 +- .../vrdisplay/cancelanimationframe/index.md | 2 +- .../web/api/vrdisplay/getframedata/index.md | 2 +- .../en-us/web/api/vrdisplay/getpose/index.md | 2 +- .../vrdisplay/requestanimationframe/index.md | 2 +- .../web/api/vrdisplay/submitframe/index.md | 2 +- .../web/api/vrframedata/timestamp/index.md | 2 +- files/en-us/web/api/vrlayerinit/index.md | 6 +- .../api/vrpose/angularacceleration/index.md | 2 +- .../web/api/vrpose/angularvelocity/index.md | 2 +- .../api/vrpose/linearacceleration/index.md | 2 +- .../web/api/vrpose/linearvelocity/index.md | 2 +- .../using_the_web_animations_api/index.md | 10 +- .../advanced_techniques/index.md | 4 +- .../web_audio_api/using_iir_filters/index.md | 6 +- .../web/api/web_authentication_api/index.md | 2 +- .../index.md | 8 +- .../using_the_web_speech_api/index.md | 4 +- .../structured_clone_algorithm/index.md | 14 +- .../using_web_workers/index.md | 8 +- .../beginquery/index.md | 2 +- .../bindvertexarray/index.md | 6 +- .../createvertexarray/index.md | 6 +- .../deletequery/index.md | 2 +- .../deletesampler/index.md | 2 +- .../deletesync/index.md | 2 +- .../deletetransformfeedback/index.md | 2 +- .../deletevertexarray/index.md | 2 +- .../webgl2renderingcontext/endquery/index.md | 2 +- .../webgl2renderingcontext/isquery/index.md | 2 +- .../webgl2renderingcontext/issampler/index.md | 2 +- .../webgl2renderingcontext/issync/index.md | 2 +- .../istransformfeedback/index.md | 2 +- .../isvertexarray/index.md | 2 +- .../pausetransformfeedback/index.md | 2 +- .../resumetransformfeedback/index.md | 2 +- .../matrix_math_for_the_web/index.md | 2 +- .../creating_3d_objects_using_webgl/index.md | 4 +- .../tutorial/lighting_in_webgl/index.md | 4 +- .../index.md | 4 +- .../tutorial/using_textures_in_webgl/index.md | 8 +- .../webgl_api/webgl_best_practices/index.md | 16 +- .../multidrawarraysinstancedwebgl/index.md | 6 +- .../checkframebufferstatus/index.md | 2 +- .../api/webglrenderingcontext/commit/index.md | 2 +- .../deletebuffer/index.md | 2 +- .../deleteframebuffer/index.md | 2 +- .../deleteprogram/index.md | 2 +- .../deleterenderbuffer/index.md | 2 +- .../deletetexture/index.md | 2 +- .../getsupportedextensions/index.md | 2 +- .../webglrenderingcontext/isprogram/index.md | 2 +- .../webglrenderingcontext/isshader/index.md | 2 +- .../connect_peers/answer_a_call/index.md | 2 +- .../connect_peers/end_a_call/index.md | 2 +- .../signaling_and_video_calling/index.md | 2 +- .../writing_websocket_server/index.md | 2 +- files/en-us/web/api/window/open/index.md | 548 ++++---------- .../web/api/window/setimmediate/index.md | 2 +- .../web/css/_colon_focus-visible/index.md | 10 +- files/en-us/web/css/box-shadow/index.md | 2 +- .../css_fonts/opentype_fonts_guide/index.md | 2 +- files/en-us/web/css/easing-function/index.md | 8 +- .../web/http/headers/set-cookie/index.md | 2 +- .../web/javascript/data_structures/index.md | 95 +-- .../functions/method_definitions/index.md | 4 +- .../global_objects/date/tostring/index.md | 6 +- .../reference/global_objects/error/index.md | 2 + .../global_objects/evalerror/index.md | 2 + .../global_objects/function/bind/index.md | 27 +- .../intl/numberformat/format/index.md | 86 ++- .../intl/numberformat/formatrange/index.md | 20 +- .../numberformat/formatrangetoparts/index.md | 72 +- .../global_objects/intl/numberformat/index.md | 4 +- .../intl/numberformat/numberformat/index.md | 212 +++--- .../numberformat/resolvedoptions/index.md | 47 +- .../global_objects/intl/pluralrules/index.md | 2 +- .../intl/pluralrules/selectrange/index.md | 13 +- .../global_objects/number/isnan/index.md | 5 +- .../number/issafeinteger/index.md | 36 +- .../global_objects/number/min_value/index.md | 4 +- .../global_objects/promise/then/index.md | 12 +- .../global_objects/rangeerror/index.md | 2 + .../global_objects/referenceerror/index.md | 2 + .../global_objects/string/@@iterator/index.md | 17 + .../reference/global_objects/string/index.md | 71 +- .../global_objects/string/length/index.md | 29 +- .../global_objects/symbol/for/index.md | 12 +- .../global_objects/symbol/keyfor/index.md | 3 +- .../global_objects/syntaxerror/index.md | 2 + .../global_objects/typedarray/from/index.md | 4 +- .../global_objects/typedarray/of/index.md | 4 +- .../global_objects/typeerror/index.md | 2 + .../global_objects/urierror/index.md | 2 + .../destructuring_assignment/index.md | 274 +++---- .../operators/spread_syntax/index.md | 212 ++---- .../reference/statements/let/index.md | 83 +- files/en-us/web/xpath/functions/index.md | 2 +- files/jsondata/GroupData.json | 2 - package.json | 2 +- yarn.lock | 12 +- 326 files changed, 7081 insertions(+), 5516 deletions(-) delete mode 100644 files/en-us/mdn/about/index.md delete mode 100644 files/en-us/mdn/contribute/howto/create_and_edit_pages/index.md delete mode 100644 files/en-us/mdn/contribute/howto/write_for_seo/index.md delete mode 100644 files/en-us/mdn/guidelines/code_guidelines/css/index.md delete mode 100644 files/en-us/mdn/guidelines/code_guidelines/general/index.md delete mode 100644 files/en-us/mdn/guidelines/code_guidelines/html/index.md delete mode 100644 files/en-us/mdn/guidelines/code_guidelines/index.md delete mode 100644 files/en-us/mdn/guidelines/code_guidelines/javascript/index.md delete mode 100644 files/en-us/mdn/guidelines/code_guidelines/shell/index.md delete mode 100644 files/en-us/mdn/guidelines/conventions_definitions/index.md delete mode 100644 files/en-us/mdn/guidelines/does_this_belong_on_mdn/index.md delete mode 100644 files/en-us/mdn/guidelines/editorial/index.md delete mode 100644 files/en-us/mdn/guidelines/writing_style_guide/index.md create mode 100644 files/en-us/mdn/writing_guidelines/attrib_copyright_license/index.md create mode 100644 files/en-us/mdn/writing_guidelines/creating_moving_deleting/index.md create mode 100644 files/en-us/mdn/writing_guidelines/experimental_deprecated_obsolete/index.md rename files/en-us/mdn/{contribute => writing_guidelines}/howto/document_a_css_property/index.md (97%) rename files/en-us/mdn/{contribute => writing_guidelines}/howto/document_an_http_header/index.md (97%) rename files/en-us/mdn/{contribute => writing_guidelines}/howto/document_web_errors/index.md (96%) create mode 100644 files/en-us/mdn/writing_guidelines/howto/index.md rename files/en-us/mdn/{contribute => writing_guidelines}/howto/tag/index.md (99%) rename files/en-us/mdn/{contribute => writing_guidelines}/howto/write_a_new_entry_in_the_glossary/index.md (98%) rename files/en-us/mdn/{contribute => writing_guidelines}/howto/write_an_api_reference/apiref-links.png (100%) rename files/en-us/mdn/{contribute => writing_guidelines}/howto/write_an_api_reference/index.md (99%) create mode 100644 files/en-us/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md rename files/en-us/mdn/{contribute => writing_guidelines}/howto/write_an_api_reference/sidebars/index.md (99%) create mode 100644 files/en-us/mdn/writing_guidelines/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/code_examples/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/frontmatter/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/images_media/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/macros/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/markdown/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/api/apiref-links.png create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/api/index.md rename files/en-us/mdn/{contribute/howto/write_an_api_reference => writing_guidelines/page_structure/page_types/api}/information_contained_in_a_webidl_file/index.md (99%) create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/api/sidebars/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/css/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/css/property/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/glossary/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/html/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/http/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/javascript/errors/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/javascript/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/page_types/learn/index.md create mode 100644 files/en-us/mdn/writing_guidelines/page_structure/updating_json/index.md create mode 100644 files/en-us/mdn/writing_guidelines/research_technology/index.md create mode 100644 files/en-us/mdn/writing_guidelines/what_we_write/criteria_for_inclusion/index.md create mode 100644 files/en-us/mdn/writing_guidelines/what_we_write/inclusion_criteria/index.md create mode 100644 files/en-us/mdn/writing_guidelines/what_we_write/index.md create mode 100644 files/en-us/mdn/writing_guidelines/writing_style_guide/code_style_guide/css/index.md create mode 100644 files/en-us/mdn/writing_guidelines/writing_style_guide/code_style_guide/html/index.md create mode 100644 files/en-us/mdn/writing_guidelines/writing_style_guide/code_style_guide/index.md create mode 100644 files/en-us/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md create mode 100644 files/en-us/mdn/writing_guidelines/writing_style_guide/code_style_guide/shell/index.md create mode 100644 files/en-us/mdn/writing_guidelines/writing_style_guide/index.md delete mode 100644 files/en-us/related/criteria_for_inclusion/index.md delete mode 100644 files/en-us/related/process_for_selection/index.md delete mode 100644 files/en-us/related/project_guidelines/index.md delete mode 100644 files/en-us/web/api/document/gotpointercapture_event/index.md create mode 100644 files/en-us/web/api/element/gotpointercapture_event/index.md create mode 100644 files/en-us/web/api/element/lostpointercapture_event/index.md delete mode 100644 files/en-us/web/api/globaleventhandlers/ongotpointercapture/index.md delete mode 100644 files/en-us/web/api/globaleventhandlers/oninvalid/index.md delete mode 100644 files/en-us/web/api/globaleventhandlers/onlostpointercapture/index.md delete mode 100644 files/en-us/web/api/globaleventhandlers/onslotchange/index.md delete mode 100644 files/en-us/web/api/htmlelement/gotpointercapture_event/index.md delete mode 100644 files/en-us/web/api/htmlelement/lostpointercapture_event/index.md diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt index dbb28aaee3fcf6f..34da2b37429e03f 100644 --- a/files/en-us/_redirects.txt +++ b/files/en-us/_redirects.txt @@ -5391,60 +5391,71 @@ /en-US/docs/Link_prefetching_FAQ /en-US/docs/Web/HTTP/Link_prefetching_FAQ /en-US/docs/Localization /en-US/docs/Glossary/Localization /en-US/docs/MDC:How_to_Help /en-US/docs/MDN/Contribute +/en-US/docs/MDN/About /en-US/docs/MDN/Writing_guidelines /en-US/docs/MDN/At_ten/Contributing_to_MDN /en-US/docs/MDN/Contribute -/en-US/docs/MDN/Contribute/Code_sample_guidelines /en-US/docs/MDN/Guidelines/Code_guidelines +/en-US/docs/MDN/Contribute/Code_sample_guidelines /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide /en-US/docs/MDN/Contribute/Content /en-US/docs/MDN/Guidelines /en-US/docs/MDN/Contribute/Content/Content_blocks /en-US/docs/MDN/Contribute/Markdown_in_MDN /en-US/docs/MDN/Contribute/Content/Custom_macros /en-US/docs/MDN/Structures/Macros/Commonly-used_macros -/en-US/docs/MDN/Contribute/Content/Layout/API_landing_page /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference -/en-US/docs/MDN/Contribute/Content/Layout/Reference_page /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference -/en-US/docs/MDN/Contribute/Content/Layout/Reference_subpage /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference +/en-US/docs/MDN/Contribute/Content/Layout/API_landing_page /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference +/en-US/docs/MDN/Contribute/Content/Layout/Reference_page /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference +/en-US/docs/MDN/Contribute/Content/Layout/Reference_subpage /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference /en-US/docs/MDN/Contribute/Content/Macros /en-US/docs/MDN/Structures/Macros /en-US/docs/MDN/Contribute/Content/Quicklinks /en-US/docs/MDN/Structures/Quicklinks /en-US/docs/MDN/Contribute/Content/Specification_tables /en-US/docs/MDN/Structures/Specification_tables -/en-US/docs/MDN/Contribute/Content/Style_guide /en-US/docs/MDN/Guidelines/Writing_style_guide -/en-US/docs/MDN/Contribute/Creating_and_editing_pages /en-US/docs/MDN/Contribute/Howto/Create_and_edit_pages +/en-US/docs/MDN/Contribute/Content/Style_guide /en-US/docs/MDN/Writing_guidelines/Writing_style_guide +/en-US/docs/MDN/Contribute/Creating_and_editing_pages /en-US/docs/MDN/Writing_guidelines/Creating_moving_deleting /en-US/docs/MDN/Contribute/Documentation_priorities https://mdn-contributor-docs.mozilla.org/legacy/documentation-priorities/ -/en-US/docs/MDN/Contribute/Does_this_belong /en-US/docs/MDN/Guidelines/Does_this_belong_on_MDN +/en-US/docs/MDN/Contribute/Does_this_belong /en-US/docs/MDN/Writing_guidelines/What_we_write /en-US/docs/MDN/Contribute/Editor/Live_samples /en-US/docs/MDN/Structures/Live_samples /en-US/docs/MDN/Contribute/FAQ /en-US/docs/MDN/Contribute /en-US/docs/MDN/Contribute/Guidelines /en-US/docs/MDN/Guidelines -/en-US/docs/MDN/Contribute/Guidelines/Best_practices /en-US/docs/MDN/Guidelines/Conventions_definitions +/en-US/docs/MDN/Contribute/Guidelines/Best_practices /en-US/docs/MDN/Writing_guidelines/Experimental_deprecated_obsolete /en-US/docs/MDN/Contribute/Guidelines/CSS_style_guide /en-US/docs/MDN/Contribute/Markdown_in_MDN -/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines /en-US/docs/MDN/Guidelines/Code_guidelines -/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/CSS /en-US/docs/MDN/Guidelines/Code_guidelines/CSS -/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/General /en-US/docs/MDN/Guidelines/Code_guidelines/General -/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/HTML /en-US/docs/MDN/Guidelines/Code_guidelines/HTML -/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/JavaScript /en-US/docs/MDN/Guidelines/Code_guidelines/JavaScript -/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/Shell /en-US/docs/MDN/Guidelines/Code_guidelines/Shell -/en-US/docs/MDN/Contribute/Guidelines/Code_samples /en-US/docs/MDN/Guidelines/Code_guidelines -/en-US/docs/MDN/Contribute/Guidelines/Content /en-US/docs/MDN/Guidelines/Does_this_belong_on_MDN +/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide +/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/CSS /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/CSS +/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/General /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide +/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/HTML /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/HTML +/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/JavaScript /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/JavaScript +/en-US/docs/MDN/Contribute/Guidelines/Code_guidelines/Shell /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/Shell +/en-US/docs/MDN/Contribute/Guidelines/Code_samples /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide +/en-US/docs/MDN/Contribute/Guidelines/Content /en-US/docs/MDN/Writing_guidelines/What_we_write /en-US/docs/MDN/Contribute/Guidelines/Content_blocks /en-US/docs/MDN/Contribute/Markdown_in_MDN -/en-US/docs/MDN/Contribute/Guidelines/Conventions_definitions /en-US/docs/MDN/Guidelines/Conventions_definitions +/en-US/docs/MDN/Contribute/Guidelines/Conventions_definitions /en-US/docs/MDN/Writing_guidelines/Experimental_deprecated_obsolete /en-US/docs/MDN/Contribute/Guidelines/Custom_macros /en-US/docs/MDN/Structures/Macros/Commonly-used_macros -/en-US/docs/MDN/Contribute/Guidelines/Does_this_belong_on_MDN /en-US/docs/MDN/Guidelines/Does_this_belong_on_MDN -/en-US/docs/MDN/Contribute/Guidelines/Editorial /en-US/docs/MDN/Guidelines/Editorial -/en-US/docs/MDN/Contribute/Guidelines/Layout/API_landing_page /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference -/en-US/docs/MDN/Contribute/Guidelines/Layout/Reference_page /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference -/en-US/docs/MDN/Contribute/Guidelines/Layout/Reference_subpage /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference +/en-US/docs/MDN/Contribute/Guidelines/Does_this_belong_on_MDN /en-US/docs/MDN/Writing_guidelines/What_we_write +/en-US/docs/MDN/Contribute/Guidelines/Editorial /en-US/docs/MDN/Writing_guidelines/What_we_write +/en-US/docs/MDN/Contribute/Guidelines/Layout/API_landing_page /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference +/en-US/docs/MDN/Contribute/Guidelines/Layout/Reference_page /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference +/en-US/docs/MDN/Contribute/Guidelines/Layout/Reference_subpage /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference /en-US/docs/MDN/Contribute/Guidelines/Macros /en-US/docs/MDN/Structures/Macros /en-US/docs/MDN/Contribute/Guidelines/Quicklinks /en-US/docs/MDN/Structures/Quicklinks /en-US/docs/MDN/Contribute/Guidelines/Specification_tables /en-US/docs/MDN/Structures/Specification_tables -/en-US/docs/MDN/Contribute/Guidelines/Style_guide /en-US/docs/MDN/Guidelines/Writing_style_guide +/en-US/docs/MDN/Contribute/Guidelines/Style_guide /en-US/docs/MDN/Writing_guidelines/Writing_style_guide /en-US/docs/MDN/Contribute/Guidelines/Video /en-US/docs/MDN/Guidelines/Video -/en-US/docs/MDN/Contribute/Guidelines/Writing_style_guide /en-US/docs/MDN/Guidelines/Writing_style_guide -/en-US/docs/MDN/Contribute/How_to_document_a_CSS_property /en-US/docs/MDN/Contribute/Howto/Document_a_CSS_property +/en-US/docs/MDN/Contribute/Guidelines/Writing_style_guide /en-US/docs/MDN/Writing_guidelines/Writing_style_guide +/en-US/docs/MDN/Contribute/How_to_document_a_CSS_property /en-US/docs/MDN/Writing_guidelines/Howto/Document_a_CSS_property /en-US/docs/MDN/Contribute/Howto/Compatibility_tables /en-US/docs/MDN/Structures/Compatibility_tables /en-US/docs/MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web/distant_example /en-US/docs/mdn/contribute/howto/create_an_interactive_exercise_to_help_learning_the_web -/en-US/docs/MDN/Contribute/Howto/How_to_document_a_CSS_property /en-US/docs/MDN/Contribute/Howto/Document_a_CSS_property +/en-US/docs/MDN/Contribute/Howto/Create_and_edit_pages /en-US/docs/MDN/Writing_guidelines/Creating_moving_deleting +/en-US/docs/MDN/Contribute/Howto/Document_a_CSS_property /en-US/docs/MDN/Writing_guidelines/Howto/Document_a_CSS_property +/en-US/docs/MDN/Contribute/Howto/Document_an_HTTP_header /en-US/docs/MDN/Writing_guidelines/Howto/Document_an_HTTP_header +/en-US/docs/MDN/Contribute/Howto/Document_web_errors /en-US/docs/MDN/Writing_guidelines/Howto/Document_web_errors +/en-US/docs/MDN/Contribute/Howto/How_to_document_a_CSS_property /en-US/docs/MDN/Writing_guidelines/Howto/Document_a_CSS_property /en-US/docs/MDN/Contribute/Howto/Notices /en-US/docs/MDN/Structures/Banners_and_notices +/en-US/docs/MDN/Contribute/Howto/Tag /en-US/docs/MDN/Writing_guidelines/Howto/Tag +/en-US/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary /en-US/docs/MDN/Writing_guidelines/Howto/Write_a_new_entry_in_the_Glossary +/en-US/docs/MDN/Contribute/Howto/Write_an_API_reference /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference +/en-US/docs/MDN/Contribute/Howto/Write_an_API_reference/Information_contained_in_a_WebIDL_file /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference/Information_contained_in_a_WebIDL_file +/en-US/docs/MDN/Contribute/Howto/Write_an_API_reference/Sidebars /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference/Sidebars +/en-US/docs/MDN/Contribute/Howto/Write_for_SEO /en-US/docs/MDN/Writing_guidelines/Writing_style_guide /en-US/docs/MDN/Contribute/Processes/Locating_browser-specific_information /en-US/docs/MDN/Contribute/Processes/Matching_features_to_browser_version /en-US/docs/MDN/Contribute/Processes/Matching_features_to_browser_versiosn /en-US/docs/MDN/Contribute/Processes/Matching_features_to_browser_version -/en-US/docs/MDN/Contribute/Sample_app_coding_guidelines /en-US/docs/MDN/Guidelines/Code_guidelines +/en-US/docs/MDN/Contribute/Sample_app_coding_guidelines /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide /en-US/docs/MDN/Contribute/Sample_server /en-US/docs/MDN/Tools/Sample_server /en-US/docs/MDN/Contribute/Structures /en-US/docs/MDN/Structures /en-US/docs/MDN/Contribute/Structures/:-ms-input-placeholder_pseudo-class /en-US/docs/Web/CSS/:placeholder-shown -/en-US/docs/MDN/Contribute/Structures/API_references/API_reference_sidebars /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference/Sidebars +/en-US/docs/MDN/Contribute/Structures/API_references/API_reference_sidebars /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference/Sidebars /en-US/docs/MDN/Contribute/Structures/Banners_and_notices /en-US/docs/MDN/Structures/Banners_and_notices /en-US/docs/MDN/Contribute/Structures/Code_examples /en-US/docs/MDN/Structures/Code_examples /en-US/docs/MDN/Contribute/Structures/Compatibility_tables /en-US/docs/MDN/Structures/Compatibility_tables @@ -5479,7 +5490,7 @@ /en-US/docs/MDN/Contribute/Style_guide/Macros /en-US/docs/MDN/Structures/Macros /en-US/docs/MDN/Contribute/Style_guide/Quicklinks /en-US/docs/MDN/Structures/Quicklinks /en-US/docs/MDN/Contribute/Style_guide/Specification_tables /en-US/docs/MDN/Structures/Specification_tables -/en-US/docs/MDN/Contribute/Tagging /en-US/docs/MDN/Contribute/Howto/Tag +/en-US/docs/MDN/Contribute/Tagging /en-US/docs/MDN/Writing_guidelines/Howto/Tag /en-US/docs/MDN/Contribute/Tasks /en-US/docs/MDN/Contribute/Getting_started /en-US/docs/MDN/Contribute/Tools /en-US/docs/MDN/Tools /en-US/docs/MDN/Contribute/Tools/Document_parameters /en-US/docs/MDN/Tools/Unsupported_GET_API @@ -5490,7 +5501,17 @@ /en-US/docs/MDN/Feedback /en-US/docs/MDN/Contribute/Feedback /en-US/docs/MDN/Getting_started /en-US/docs/MDN/Contribute/Getting_started /en-US/docs/MDN/Guidelines/CSS_style_guide /en-US/docs/MDN/Contribute/Markdown_in_MDN -/en-US/docs/MDN/Guidelines/Content /en-US/docs/MDN/Guidelines/Does_this_belong_on_MDN +/en-US/docs/MDN/Guidelines/Code_guidelines /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide +/en-US/docs/MDN/Guidelines/Code_guidelines/CSS /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/CSS +/en-US/docs/MDN/Guidelines/Code_guidelines/General /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide +/en-US/docs/MDN/Guidelines/Code_guidelines/HTML /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/HTML +/en-US/docs/MDN/Guidelines/Code_guidelines/JavaScript /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/JavaScript +/en-US/docs/MDN/Guidelines/Code_guidelines/Shell /en-US/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/Shell +/en-US/docs/MDN/Guidelines/Content /en-US/docs/MDN/Writing_guidelines/What_we_write +/en-US/docs/MDN/Guidelines/Conventions_definitions /en-US/docs/MDN/Writing_guidelines/Experimental_deprecated_obsolete +/en-US/docs/MDN/Guidelines/Does_this_belong_on_MDN /en-US/docs/MDN/Writing_guidelines/What_we_write +/en-US/docs/MDN/Guidelines/Editorial /en-US/docs/MDN/Writing_guidelines/What_we_write +/en-US/docs/MDN/Guidelines/Writing_style_guide /en-US/docs/MDN/Writing_guidelines/Writing_style_guide /en-US/docs/MDN/JavaScript /en-US/docs/Web/JavaScript /en-US/docs/MDN/Kuma /en-US/docs/MDN/Yari /en-US/docs/MDN/Kuma/API /en-US/docs/MDN/Tools/Unsupported_GET_API @@ -5506,7 +5527,7 @@ /en-US/docs/MDN/MDN_Product_Avisory_Board/Membership /en-US/docs/MDN/MDN_Product_Advisory_Board/Membership /en-US/docs/MDN/Quick_start /en-US/docs/MDN/Contribute/Getting_started /en-US/docs/MDN/Structures/:-ms-input-placeholder_pseudo-class /en-US/docs/Web/CSS/:placeholder-shown -/en-US/docs/MDN/Structures/API_references/API_reference_sidebars /en-US/docs/MDN/Contribute/Howto/Write_an_API_reference/Sidebars +/en-US/docs/MDN/Structures/API_references/API_reference_sidebars /en-US/docs/MDN/Writing_guidelines/Howto/Write_an_API_reference/Sidebars /en-US/docs/MDN/Structures/Content_blocks /en-US/docs/MDN/Contribute/Markdown_in_MDN /en-US/docs/MDN/Tools/Document_parameters /en-US/docs/MDN/Tools/Unsupported_GET_API /en-US/docs/MDN/User_guide /en-US/docs/MDN/Tools @@ -6355,9 +6376,12 @@ /en-US/docs/Range/toString /en-US/docs/Web/API/range/toString /en-US/docs/ReadableStream /en-US/docs/Web/API/ReadableStream /en-US/docs/Regexp/match /en-US/docs/Web/EXSLT/regexp/match +/en-US/docs/Related/Criteria_for_inclusion /en-US/docs/MDN/Writing_guidelines/What_we_write/Criteria_for_inclusion /en-US/docs/Related/IMSC/Layout_in_IMSC /en-US/docs/Related/IMSC/Subtitle_placement /en-US/docs/Related/IMSC/Mapping_Time_Code_to_IMSC /en-US/docs/Related/IMSC/Mapping_video_time_codes_to_IMSC /en-US/docs/Related/IMSC/Using_imscJS_as_polyfill /en-US/docs/Related/IMSC/Using_the_imscJS_polyfill +/en-US/docs/Related/Process_for_selection /en-US/docs/MDN/Writing_guidelines/What_we_write/Criteria_for_inclusion +/en-US/docs/Related/Project_guidelines /en-US/docs/MDN/Writing_guidelines/What_we_write/Criteria_for_inclusion /en-US/docs/Resource_Timing_API /en-US/docs/Web/API/Resource_Timing_API /en-US/docs/SGML /en-US/docs/Glossary/SGML /en-US/docs/SMTP /en-US/docs/Glossary/SMTP @@ -7821,6 +7845,7 @@ /en-US/docs/Web/API/Document/defaultView/storage_event /en-US/docs/Web/API/Window/storage_event /en-US/docs/Web/API/Document/domConfig /en-US/docs/Web/API/Document /en-US/docs/Web/API/Document/getBoxObjectFor /en-US/docs/Web/API/Element/getBoundingClientRect +/en-US/docs/Web/API/Document/gotpointercapture_event /en-US/docs/Web/API/Element/gotpointercapture_event /en-US/docs/Web/API/Document/inputEncoding /en-US/docs/Web/API/document/characterSet /en-US/docs/Web/API/Document/keydown_event /en-US/docs/Web/API/Element/keydown_event /en-US/docs/Web/API/Document/keypress_event /en-US/docs/Web/API/Element/keypress_event @@ -7943,15 +7968,13 @@ /en-US/docs/Web/API/Element/attachInternals /en-US/docs/Web/API/HTMLElement/attachInternals /en-US/docs/Web/API/Element/cancel_event /en-US/docs/Web/API/HTMLDialogElement/cancel_event /en-US/docs/Web/API/Element/fullscreenchange /en-US/docs/Web/API/Element/fullscreenchange_event -/en-US/docs/Web/API/Element/gotpointercapture_event /en-US/docs/Web/API/HTMLElement/gotpointercapture_event -/en-US/docs/Web/API/Element/lostpointercapture_event /en-US/docs/Web/API/HTMLElement/lostpointercapture_event /en-US/docs/Web/API/Element/mozRequestFullScreen /en-US/docs/Web/API/Element/requestFullScreen /en-US/docs/Web/API/Element/msMatchesSelector /en-US/docs/Web/API/Element/matches /en-US/docs/Web/API/Element/name /en-US/docs/Web/API /en-US/docs/Web/API/Element/onfullscreenchange /en-US/docs/Web/API/Element/fullscreenchange_event /en-US/docs/Web/API/Element/onfullscreenerror /en-US/docs/Web/API/Element/fullscreenerror_event -/en-US/docs/Web/API/Element/ongotpointercapture /en-US/docs/Web/API/GlobalEventHandlers/ongotpointercapture -/en-US/docs/Web/API/Element/onlostpointercapture /en-US/docs/Web/API/GlobalEventHandlers/onlostpointercapture +/en-US/docs/Web/API/Element/ongotpointercapture /en-US/docs/Web/API/Element/gotpointercapture_event +/en-US/docs/Web/API/Element/onlostpointercapture /en-US/docs/Web/API/Element/lostpointercapture_event /en-US/docs/Web/API/Element/onwheel /en-US/docs/Web/API/Element/wheel_event /en-US/docs/Web/API/Element/pointerlockchange_event /en-US/docs/Web/API/Document/pointerlockchange_event /en-US/docs/Web/API/Element/resourcetimingbufferfull_event /en-US/docs/Web/API/Performance/resourcetimingbufferfull_event @@ -8124,7 +8147,7 @@ /en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.ondurationchange /en-US/docs/Web/API/HTMLMediaElement/durationchange_event /en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.onemptied /en-US/docs/Web/API/HTMLMediaElement/emptied_event /en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.onended /en-US/docs/Web/API/HTMLMediaElement/ended_event -/en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.oninvalid /en-US/docs/Web/API/GlobalEventHandlers/oninvalid +/en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.oninvalid /en-US/docs/Web/API/HTMLInputElement/invalid_event /en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.onloadeddata /en-US/docs/Web/API/GlobalEventHandlers/onloadeddata /en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.onloadedmetadata /en-US/docs/Web/API/GlobalEventHandlers/onloadedmetadata /en-US/docs/Web/API/GlobalEventHandlers/GlobalEventHandlers.onloadstart /en-US/docs/Web/API/GlobalEventHandlers/onloadstart @@ -8163,10 +8186,13 @@ /en-US/docs/Web/API/GlobalEventHandlers/onended /en-US/docs/Web/API/HTMLMediaElement/ended_event /en-US/docs/Web/API/GlobalEventHandlers/onfocus /en-US/docs/Web/API/Window/focus_event /en-US/docs/Web/API/GlobalEventHandlers/onformdata /en-US/docs/Web/API/HTMLFormElement/formdata_event +/en-US/docs/Web/API/GlobalEventHandlers/ongotpointercapture /en-US/docs/Web/API/Element/gotpointercapture_event /en-US/docs/Web/API/GlobalEventHandlers/oninput /en-US/docs/Web/API/HTMLElement/input_event +/en-US/docs/Web/API/GlobalEventHandlers/oninvalid /en-US/docs/Web/API/HTMLInputElement/invalid_event /en-US/docs/Web/API/GlobalEventHandlers/onkeydown /en-US/docs/Web/API/Element/keydown_event /en-US/docs/Web/API/GlobalEventHandlers/onkeypress /en-US/docs/Web/API/Element/keypress_event /en-US/docs/Web/API/GlobalEventHandlers/onkeyup /en-US/docs/Web/API/Element/keyup_event +/en-US/docs/Web/API/GlobalEventHandlers/onlostpointercapture /en-US/docs/Web/API/Element/lostpointercapture_event /en-US/docs/Web/API/GlobalEventHandlers/onmousedown /en-US/docs/Web/API/Element/mousedown_event /en-US/docs/Web/API/GlobalEventHandlers/onmouseenter /en-US/docs/Web/API/Element/mouseenter_event /en-US/docs/Web/API/GlobalEventHandlers/onmouseleave /en-US/docs/Web/API/Element/mouseleave_event @@ -8193,6 +8219,7 @@ /en-US/docs/Web/API/GlobalEventHandlers/onselect /en-US/docs/Web/API/HTMLInputElement/select_event /en-US/docs/Web/API/GlobalEventHandlers/onselectionchange /en-US/docs/Web/API/HTMLInputElement/selectionchange_event /en-US/docs/Web/API/GlobalEventHandlers/onselectstart /en-US/docs/Web/API/Document/selectstart_event +/en-US/docs/Web/API/GlobalEventHandlers/onslotchange /en-US/docs/Web/API/HTMLSlotElement/slotchange_event /en-US/docs/Web/API/GlobalEventHandlers/onsubmit /en-US/docs/Web/API/HTMLFormElement/submit_event /en-US/docs/Web/API/GlobalEventHandlers/ontouchcancel /en-US/docs/Web/API/Element/touchcancel_event /en-US/docs/Web/API/GlobalEventHandlers/ontouchend /en-US/docs/Web/API/Element/touchend_event @@ -8263,7 +8290,9 @@ /en-US/docs/Web/API/HTMLElement/animationiteration_event /en-US/docs/Web/API/Element/animationiteration_event /en-US/docs/Web/API/HTMLElement/animationstart_event /en-US/docs/Web/API/Element/animationstart_event /en-US/docs/Web/API/HTMLElement/forceSpellCheck /en-US/docs/Web/HTML/Global_attributes/spellcheck +/en-US/docs/Web/API/HTMLElement/gotpointercapture_event /en-US/docs/Web/API/Element/gotpointercapture_event /en-US/docs/Web/API/HTMLElement/invalid_event /en-US/docs/Web/API/HTMLInputElement/invalid_event +/en-US/docs/Web/API/HTMLElement/lostpointercapture_event /en-US/docs/Web/API/Element/lostpointercapture_event /en-US/docs/Web/API/HTMLElement/onabort /en-US/docs/Web/API/HTMLMediaElement/abort_event /en-US/docs/Web/API/HTMLElement/onblur /en-US/docs/Web/API/Window/blur_event /en-US/docs/Web/API/HTMLElement/onchange /en-US/docs/Web/API/HTMLElement/change_event @@ -11410,7 +11439,7 @@ /en-US/docs/Web/Events/gesturechange /en-US/docs/Web/API/Element/gesturechange_event /en-US/docs/Web/Events/gestureend /en-US/docs/Web/API/Element/gestureend_event /en-US/docs/Web/Events/gesturestart /en-US/docs/Web/API/Element/gesturestart_event -/en-US/docs/Web/Events/gotpointercapture /en-US/docs/Web/API/HTMLElement/gotpointercapture_event +/en-US/docs/Web/Events/gotpointercapture /en-US/docs/Web/API/Element/gotpointercapture_event /en-US/docs/Web/Events/hashchange /en-US/docs/Web/API/Window/hashchange_event /en-US/docs/Web/Events/icecandidate /en-US/docs/Web/API/RTCPeerConnection/icecandidate_event /en-US/docs/Web/Events/iceconnectionstatechange /en-US/docs/Web/API/RTCPeerConnection/iceconnectionstatechange_event @@ -11429,7 +11458,7 @@ /en-US/docs/Web/Events/loadedmetadata /en-US/docs/Web/API/HTMLMediaElement/loadedmetadata_event /en-US/docs/Web/Events/loadend /en-US/docs/Web/API/XMLHttpRequest/loadend_event /en-US/docs/Web/Events/loadstart /en-US/docs/Web/API/XMLHttpRequest/loadstart_event -/en-US/docs/Web/Events/lostpointercapture /en-US/docs/Web/API/HTMLElement/lostpointercapture_event +/en-US/docs/Web/Events/lostpointercapture /en-US/docs/Web/API/Element/lostpointercapture_event /en-US/docs/Web/Events/mark /en-US/docs/Web/API/SpeechSynthesisUtterance/mark_event /en-US/docs/Web/Events/merchantvalidation /en-US/docs/Web/API/PaymentRequest/merchantvalidation_event /en-US/docs/Web/Events/message /en-US/docs/Web/API/BroadcastChannel/message_event diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json index 696ac1003e75b64..64fed28512c727e 100644 --- a/files/en-us/_wikihistory.json +++ b/files/en-us/_wikihistory.json @@ -13011,55 +13011,6 @@ "ziyunfei" ] }, - "MDN/About": { - "modified": "2020-04-22T17:54:34.199Z", - "contributors": [ - "jswisher", - "SphinxKnight", - "rana.dadu.77", - "mfuji09", - "cogpark", - "darby", - "AlemFarid", - "Grae-Drake", - "chrisdavidmills", - "Mirinth", - "envisioncodes", - "9999472", - "wbamberg", - "Sheppy", - "asmforce", - "jwhitlock", - "Jenna59", - "CrazyChick63", - "rbg3434", - "fitojb", - "Slawek37", - "leandroruel", - "LimeClover", - "serv-inc", - "dvincent", - "adminisrator", - "groovecoder", - "teoli", - "lewiscartman", - "microsoft", - "Sanantananda", - "wakka27", - "fscholz", - "moh.sugiarta", - "Jeremie", - "onei", - "eddyng23", - "cherrylover85", - "altigere", - "davidsuisse1", - "cdac", - "BenB", - "ethertank", - "Gerv" - ] - }, "MDN/At_ten": { "modified": "2020-12-14T11:30:31.427Z", "contributors": [ @@ -13407,203 +13358,6 @@ "Jeremie" ] }, - "MDN/Contribute/Howto/Create_and_edit_pages": { - "modified": "2020-12-14T11:30:49.881Z", - "contributors": [ - "SphinxKnight", - "rathore.solar", - "Sultanlido", - "sideshowbarker", - "osshomes2", - "Vfikr", - "chrisdavidmills", - "fahimsahriarfahad", - "fahimfahad35", - "Cancan", - "bestfitnessgear4u", - "nowseoagency", - "Bali", - "netnedir", - "ali78ahmed89", - "alattalatta", - "igomarta", - "televisiontadka219", - "bullrider78", - "puqlunk", - "qureshiashraf207", - "stevehendrym95", - "mrsumantabagh", - "pamtentcm", - "BΓΌlteni", - "soujanyatelebu", - "PeterParker", - "learnearnguru", - "sosyaladres", - "safetycargopackers", - "yilmazolak35", - "jswisher", - "mandyakrs333", - "RomeRoot", - "kshitizp11", - "mfuji09", - "kokselvinc1", - "silkroadpharmacy01", - "Anonymous", - "prayagch", - "Hairistanbul", - "avasamedu", - "thesourcing.co", - "zhaoy88", - "Iam4re4L", - "CorfinaCapital", - "rajninegi786", - "sachinksamad", - "astrologylover", - "Yazid-CH", - "sudewadewi", - "aditya966560", - "Gururobert", - "Nawaf91", - "ij-startcanonco", - "abiebdragx", - "WEBSARB", - "xanderdb", - "Sumi_Oneness", - "ludochat", - "amiexporter", - "BURSASEO", - "sjsudan", - "subha7595", - "thesid01", - "sandeeppushp", - "kogei1", - "wbamberg", - "carterehc", - "10yendama", - "Romadmin", - "bebo2019", - "WIPocket", - "david_ross", - "adonthis", - "dafoeuf", - "Sheppy", - "himanshuxd", - "hannah3745", - "shubhamArora15", - "amanmahendra00", - "MrPj2u", - "charliecalvert", - "Milena2a", - "AppireddyT", - "stephaniehobson", - "Purnima-Ahirao", - "Gregjarvez", - "Alvey_oo5", - "ankitkamboj0", - "apoorvasingh17", - "Pratul1997", - "Teleburna", - "sebastianross", - "adirapinjamandana", - "timvuon", - "pcat", - "jwhitlock", - "SCO", - "rjanjic", - "Phe0nix", - "Coconut35101", - "villaalina", - "carrbrian180", - "KadirTopal", - "meganioe01lis", - "artistics-weddings", - "Herve-Mention", - "Vemaybaygiare-avia.vn", - "tonnywilliams", - "sandymillerSM", - "liuhy46", - "jsx", - "zerohost", - "nadiraltinbas", - "bhardwaj_75", - "aje44rseyscz", - "ZoroarkShade", - "cristianeramalho", - "Cassanta", - "DineshMv", - "netbun", - "ihsibosmonaj", - "Freelancer.MK", - "dek", - "teoli", - "tvchaska12", - "jakovkacan", - "astromechology", - "armukul", - "juan-castano", - "apoorva", - "Sharath_George_M", - "sreejith_sreedhar", - "arefin", - "Shafayet101", - "mothasimroman", - "sarthak.s", - "SandyStorm", - "byhorror", - "ajeya", - "mnedrow", - "jncraton", - "adeelimtiaz90", - "watership", - "Jack_Duthen", - "Mehmet_Kani", - "akhilnaik", - "trevorh", - "VarunKaushik", - "geek14", - "canisssius", - "arkapravamajumder", - "maybe", - "Graham2k13", - "crazy4years", - "williamr", - "SHELI", - "freebirdmrk", - "mgnrsb" - ] - }, - "MDN/Contribute/Howto/Document_a_CSS_property": { - "modified": "2020-02-18T19:54:27.563Z", - "contributors": [ - "jswisher", - "SphinxKnight", - "wbamberg", - "mfluehr", - "fscholz", - "teoli", - "Sebastianz", - "stephaniehobson", - "dharkness", - "FredB", - "Sheppy" - ] - }, - "MDN/Contribute/Howto/Document_an_HTTP_header": { - "modified": "2020-10-15T21:47:59.093Z", - "contributors": [ - "jpmedley", - "wbamberg", - "Jeremie", - "fscholz" - ] - }, - "MDN/Contribute/Howto/Document_web_errors": { - "modified": "2019-01-16T22:58:13.741Z", - "contributors": [ - "wbamberg", - "fscholz" - ] - }, "MDN/Contribute/Howto/Migrate_external_content_to_MDN": { "modified": "2019-07-15T08:26:43.504Z", "contributors": [ @@ -13622,43 +13376,6 @@ "hamasaki" ] }, - "MDN/Contribute/Howto/Tag": { - "modified": "2020-03-25T16:30:08.477Z", - "contributors": [ - "Sheppy", - "jswisher", - "FeRDNYC", - "kenj115188", - "sideshowbarker", - "ExE-Boss", - "mfuji09", - "wbamberg", - "lucian95", - "johnjago", - "KadirTopal", - "pqpace", - "SphinxKnight", - "Bodo1445", - "helperman", - "devanshmanu", - "dkocho4", - "Uemmra3", - "ganshenhai", - "Jeremie", - "kiloan.com", - "Riyaj786", - "Andrew_Pfeiffer", - "dio", - "dwj83624", - "marowilson", - "fscholz", - "Newser", - "vernvernvern", - "maybe", - "teoli", - "markg" - ] - }, "MDN/Contribute/Howto/Update_the_CSS_JSON_DB": { "modified": "2019-03-23T22:47:20.816Z", "contributors": [ @@ -13671,78 +13388,6 @@ "teoli" ] }, - "MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary": { - "modified": "2020-12-14T04:30:45.303Z", - "contributors": [ - "mfuji09", - "ohaver", - "cadorej", - "wbamberg", - "Sheppy", - "jswisher", - "Aleksej", - "fscholz", - "Andrew_Pfeiffer", - "Jeremie", - "hbloomer", - "nasifmdtanjim" - ] - }, - "MDN/Contribute/Howto/Write_an_API_reference": { - "modified": "2019-05-03T10:17:00.872Z", - "contributors": [ - "Sheppy", - "wbamberg", - "stephaniehobson", - "Jedipedia", - "jpmedley", - "chrisdavidmills", - "fscholz", - "Sebastianz", - "jswisher", - "essymo", - "maybe", - "ifilin", - "AFBarstow", - "teoli", - "ChrisL" - ] - }, - "MDN/Contribute/Howto/Write_an_API_reference/Information_contained_in_a_WebIDL_file": { - "modified": "2019-10-01T06:57:46.015Z", - "contributors": [ - "chrisdavidmills", - "Bzbarsky", - "fscholz", - "wbamberg", - "Sheppy", - "xfq", - "teoli", - "overholt", - "markg", - "jswisher", - "jryans" - ] - }, - "MDN/Contribute/Howto/Write_an_API_reference/Sidebars": { - "modified": "2020-09-30T09:04:08.085Z", - "contributors": [ - "chrisdavidmills", - "Zearin_Galaurum", - "Sheppy", - "wbamberg", - "Thw0rted" - ] - }, - "MDN/Contribute/Howto/Write_for_SEO": { - "modified": "2020-04-29T13:47:45.328Z", - "contributors": [ - "arjenlgill", - "wbamberg", - "Sheppy", - "Havvy" - ] - }, "MDN/Contribute/Localize": { "modified": "2020-12-12T05:45:10.381Z", "contributors": [ @@ -13938,103 +13583,6 @@ "Sheppy" ] }, - "MDN/Guidelines/Writing_style_guide": { - "modified": "2020-11-29T07:56:57.741Z", - "contributors": [ - "david.cdb004", - "SphinxKnight", - "nasseralzafer", - "chrisdavidmills", - "Zearin_Galaurum", - "Sheppy", - "mfuji09", - "Koavf", - "as.dillidonau.schrottmetalle", - "jswisher", - "televators", - "sideshowbarker", - "junnydelacruz", - "bershanskiy", - "ronald115188", - "wbamberg", - "horndoc", - "jenlouie", - "eToThePi-i", - "mfluehr", - "karlstolley", - "zfJames", - "coolmanishks", - "zedlambrecht", - "Tomche", - "xfq", - "Cthutq1", - "Clusker", - "247flashgames", - "akqj10", - "Sebastianz", - "WynnChen", - "PeterCapek", - "rolfedh", - "teoli", - "frbi", - "hoosteeno", - "Kovu", - "viny0972", - "takto", - "MandyChong", - "katarzyna1212.77", - "StephenKelly", - "OlingCat", - "Somnlent", - "SpyrosGkliatis", - "williamr", - "dbs", - "CJarie", - "enderandpeter", - "ethertank", - "madarche", - "jenzed", - "jackblack", - "Havvy", - "Lanoxx", - "markg", - "grendel", - "syssgx", - "SamB", - "P.A.", - "fscholz", - "Naesten", - "mgrassotti", - "George3", - "Racemoza", - "Edburns@acm.org", - "Mook", - "Mattg", - "Warddr", - "Yujin hong", - "BenoitL", - "Nc15", - "Nickolay", - "Ali h", - "Okome", - "Callek", - "Vilas", - "Ptak82", - "Cab", - "Leandro MercΓͺs Xavier", - "Mw22", - "Dria", - "Skierpage", - "Gema", - "Kakurady", - "Csentis", - "Shimono", - "Yor.feix", - "GrandeBuzina", - "Pitchum", - "Tuqui" - ] - }, "MDN/MDN_Product_Advisory_Board": { "modified": "2019-06-05T12:41:23.682Z", "contributors": [ @@ -14468,6 +14016,138 @@ "jswisher" ] }, + "MDN/Writing_guidelines/Howto/Document_a_CSS_property": { + "modified": "2020-02-18T19:54:27.563Z", + "contributors": [ + "jswisher", + "SphinxKnight", + "wbamberg", + "mfluehr", + "fscholz", + "teoli", + "Sebastianz", + "stephaniehobson", + "dharkness", + "FredB", + "Sheppy" + ] + }, + "MDN/Writing_guidelines/Howto/Document_an_HTTP_header": { + "modified": "2020-10-15T21:47:59.093Z", + "contributors": [ + "jpmedley", + "wbamberg", + "Jeremie", + "fscholz" + ] + }, + "MDN/Writing_guidelines/Howto/Document_web_errors": { + "modified": "2019-01-16T22:58:13.741Z", + "contributors": [ + "wbamberg", + "fscholz" + ] + }, + "MDN/Writing_guidelines/Howto/Tag": { + "modified": "2020-03-25T16:30:08.477Z", + "contributors": [ + "Sheppy", + "jswisher", + "FeRDNYC", + "kenj115188", + "sideshowbarker", + "ExE-Boss", + "mfuji09", + "wbamberg", + "lucian95", + "johnjago", + "KadirTopal", + "pqpace", + "SphinxKnight", + "Bodo1445", + "helperman", + "devanshmanu", + "dkocho4", + "Uemmra3", + "ganshenhai", + "Jeremie", + "kiloan.com", + "Riyaj786", + "Andrew_Pfeiffer", + "dio", + "dwj83624", + "marowilson", + "fscholz", + "Newser", + "vernvernvern", + "maybe", + "teoli", + "markg" + ] + }, + "MDN/Writing_guidelines/Howto/Write_a_new_entry_in_the_Glossary": { + "modified": "2020-12-14T04:30:45.303Z", + "contributors": [ + "mfuji09", + "ohaver", + "cadorej", + "wbamberg", + "Sheppy", + "jswisher", + "Aleksej", + "fscholz", + "Andrew_Pfeiffer", + "Jeremie", + "hbloomer", + "nasifmdtanjim" + ] + }, + "MDN/Writing_guidelines/Howto/Write_an_API_reference": { + "modified": "2019-05-03T10:17:00.872Z", + "contributors": [ + "Sheppy", + "wbamberg", + "stephaniehobson", + "Jedipedia", + "jpmedley", + "chrisdavidmills", + "fscholz", + "Sebastianz", + "jswisher", + "essymo", + "maybe", + "ifilin", + "AFBarstow", + "teoli", + "ChrisL" + ] + }, + "MDN/Writing_guidelines/Howto/Write_an_API_reference/Information_contained_in_a_WebIDL_file": { + "modified": "2019-10-01T06:57:46.015Z", + "contributors": [ + "chrisdavidmills", + "Bzbarsky", + "fscholz", + "wbamberg", + "Sheppy", + "xfq", + "teoli", + "overholt", + "markg", + "jswisher", + "jryans" + ] + }, + "MDN/Writing_guidelines/Howto/Write_an_API_reference/Sidebars": { + "modified": "2020-09-30T09:04:08.085Z", + "contributors": [ + "chrisdavidmills", + "Zearin_Galaurum", + "Sheppy", + "wbamberg", + "Thw0rted" + ] + }, "MDN/Yari": { "modified": "2019-12-31T16:22:53.307Z", "contributors": [ @@ -23410,12 +23090,6 @@ "chrisdavidmills" ] }, - "Related/Criteria_for_inclusion": { - "modified": "2019-03-18T21:27:13.650Z", - "contributors": [ - "chrisdavidmills" - ] - }, "Related/IMSC": { "modified": "2019-03-26T05:50:28.680Z", "contributors": [ @@ -23488,19 +23162,6 @@ "tairt" ] }, - "Related/Process_for_selection": { - "modified": "2019-03-18T21:27:06.862Z", - "contributors": [ - "chrisdavidmills" - ] - }, - "Related/Project_guidelines": { - "modified": "2019-03-18T21:27:02.057Z", - "contributors": [ - "tairt", - "chrisdavidmills" - ] - }, "Web": { "modified": "2020-12-10T17:35:24.113Z", "contributors": [ @@ -35222,15 +34883,6 @@ "david_ross" ] }, - "Web/API/Document/gotpointercapture_event": { - "modified": "2020-10-15T22:14:51.520Z", - "contributors": [ - "Clarkkkk", - "Wind1808", - "mfuji09", - "wbamberg" - ] - }, "Web/API/Document/hasFocus": { "modified": "2020-10-15T21:04:29.544Z", "contributors": [ @@ -38716,6 +38368,22 @@ "Andreas Wuest" ] }, + "Web/API/Element/gotpointercapture_event": { + "modified": "2020-10-15T21:39:52.295Z", + "contributors": [ + "Clarkkkk", + "gaearon", + "mfuji09", + "Wind1808", + "wbamberg", + "mfluehr", + "chrisdavidmills", + "fscholz", + "erikadoyle", + "rolfedh", + "AFBarstow" + ] + }, "Web/API/Element/hasAttribute": { "modified": "2020-10-15T21:11:17.789Z", "contributors": [ @@ -39018,6 +38686,22 @@ "Sebastianz" ] }, + "Web/API/Element/lostpointercapture_event": { + "modified": "2020-10-15T21:39:53.427Z", + "contributors": [ + "Clarkkkk", + "gaearon", + "mfuji09", + "Wind1808", + "wbamberg", + "mfluehr", + "chrisdavidmills", + "fscholz", + "erikadoyle", + "rolfedh", + "AFBarstow" + ] + }, "Web/API/Element/matches": { "modified": "2020-10-15T21:06:50.561Z", "contributors": [ @@ -44278,30 +43962,6 @@ "alecananian" ] }, - "Web/API/GlobalEventHandlers/ongotpointercapture": { - "modified": "2020-10-15T21:51:24.512Z", - "contributors": [ - "mfuji09", - "Wind1808", - "wbamberg", - "mfluehr", - "chrisdavidmills", - "fscholz", - "david_ross", - "jpmedley" - ] - }, - "Web/API/GlobalEventHandlers/oninvalid": { - "modified": "2020-10-15T21:44:05.936Z", - "contributors": [ - "mfluehr", - "fscholz", - "sideshowbarker", - "wbamberg", - "rolfedh", - "Guillaume-Heras" - ] - }, "Web/API/GlobalEventHandlers/onload": { "modified": "2020-10-15T21:12:46.292Z", "contributors": [ @@ -44381,18 +44041,6 @@ "Guillaume-Heras" ] }, - "Web/API/GlobalEventHandlers/onlostpointercapture": { - "modified": "2020-10-15T21:51:24.333Z", - "contributors": [ - "Wind1808", - "wbamberg", - "mfluehr", - "chrisdavidmills", - "fscholz", - "david_ross", - "jpmedley" - ] - }, "Web/API/GlobalEventHandlers/onpause": { "modified": "2020-10-15T21:44:06.725Z", "contributors": [ @@ -45770,22 +45418,6 @@ "JesseW" ] }, - "Web/API/HTMLElement/gotpointercapture_event": { - "modified": "2020-10-15T21:39:52.295Z", - "contributors": [ - "Clarkkkk", - "gaearon", - "mfuji09", - "Wind1808", - "wbamberg", - "mfluehr", - "chrisdavidmills", - "fscholz", - "erikadoyle", - "rolfedh", - "AFBarstow" - ] - }, "Web/API/HTMLElement/hidden": { "modified": "2020-10-15T21:56:20.245Z", "contributors": [ @@ -45903,22 +45535,6 @@ "JesseW" ] }, - "Web/API/HTMLElement/lostpointercapture_event": { - "modified": "2020-10-15T21:39:53.427Z", - "contributors": [ - "Clarkkkk", - "gaearon", - "mfuji09", - "Wind1808", - "wbamberg", - "mfluehr", - "chrisdavidmills", - "fscholz", - "erikadoyle", - "rolfedh", - "AFBarstow" - ] - }, "Web/API/HTMLElement/mscandidatewindowhide_event": { "modified": "2019-03-18T21:30:58.857Z", "contributors": [ diff --git a/files/en-us/glossary/global_object/index.md b/files/en-us/glossary/global_object/index.md index 50b48bdbd47ffcd..c8c8592304ef108 100644 --- a/files/en-us/glossary/global_object/index.md +++ b/files/en-us/glossary/global_object/index.md @@ -14,50 +14,11 @@ In JavaScript, there's always a global object defined. In a web browser, when sc - Code running in a {{domxref("Worker")}} has a {{domxref("WorkerGlobalScope")}} object as its global object. - Scripts running under {{Glossary("Node.js")}} have an object called [`global`](https://nodejs.org/api/globals.html#globals_global) as their global object. -> **Note**: Unlike {{jsxref("Statements/var", "var")}}, the statements {{jsxref("Statements/let", "let")}} and {{jsxref("Statements/const", "const")}} do not create properties of the global object. +The [`globalThis`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis) global property allows one to access the global object regardless of the current environment. -## `window` object in the Browser +[`var`](/en-US/docs/Web/JavaScript/Reference/Statements/var) statements and [function declarations](/en-US/docs/Web/JavaScript/Reference/Statements/function) at the top level create properties of the global object. On the other hand, {{jsxref("Statements/let", "let")}} and {{jsxref("Statements/const", "const")}} declarations never create properties of the global object. -The `window` object is the Global Object in the Browser. Any Global Variables or Functions can be accessed as _properties_ of the `window` object. - -### Access Global Variables - -```js -var foo = "foobar"; -foo === window.foo; // Returns: true -``` - -After defining a Global Variable `foo`, we can access its value directly from the `window` object, by using the variable name `foo` as a property name of the Global Object `window.foo`. - -#### Explanation: - -The global variable `foo` was stored in the `window` object, like this: - -```js -foo: "foobar" -``` - -### Access Global Functions - -```js -function greeting() { - console.log("Hi!"); -} - -window.greeting(); // It is the same as the normal invoking: greeting(); -``` - -The example above explains how Global Functions are stored as _properties_ in the `window` object. We created a Global Function called `greeting`, then invoked it using the `window` object. - -#### Explanation: - -The global function `greeting` was stored in the `window` object, like this: - -```js -greeting: function greeting() { - console.log("Hi!"); -} -``` +The properties of the global object are automatically added to the {{glossary("global scope")}}. ## See also diff --git a/files/en-us/glossary/shadow_tree/index.md b/files/en-us/glossary/shadow_tree/index.md index 71481be589f364c..15a5b8c5e34a469 100644 --- a/files/en-us/glossary/shadow_tree/index.md +++ b/files/en-us/glossary/shadow_tree/index.md @@ -7,7 +7,7 @@ tags: - Shadow Tree - shadow DOM --- -A **shadow tree** is a tree of DOM {{Glossary("node", "nodes")}} whose topmost node is a **shadow root**; that is, the topmost node within a **shadow DOM**. A shadow tree is a hidden set of standard DOM nodes which is attached to a standard DOM node that serves as a host. The hidden nodes are not directly visible using regular DOM functionality, but require the use of a special [Shadow DOM API](/en-US/docs/Web/Web_Components/Using_shadow_DOM) to access. +A **shadow tree** is a tree of DOM [nodes](/en-US/docs/Glossary/Node/DOM) whose topmost node is a **shadow root**; that is, the topmost node within a **shadow DOM**. A shadow tree is a hidden set of standard DOM nodes which is attached to a standard DOM node that serves as a host. The hidden nodes are not directly visible using regular DOM functionality, but require the use of a special [Shadow DOM API](/en-US/docs/Web/Web_Components/Using_shadow_DOM) to access. Nodes within the shadow tree are not affected by anything applied outside the shadow tree, and vice versa. This provides a way to encapsulate implementation details, which is especially useful for custom elements and other advanced design paradigms. diff --git a/files/en-us/learn/javascript/first_steps/silly_story_generator/index.md b/files/en-us/learn/javascript/first_steps/silly_story_generator/index.md index 9da9e0b5522cc78..82bf8291a624639 100644 --- a/files/en-us/learn/javascript/first_steps/silly_story_generator/index.md +++ b/files/en-us/learn/javascript/first_steps/silly_story_generator/index.md @@ -55,7 +55,7 @@ You have been provided with some raw HTML/CSS and a few text strings and JavaScr - Generates a silly story when the "Generate random story" button is pressed. - Replaces the default name "Bob" in the story with a custom name, only if a custom name is entered into the "Enter custom name" text field before the generate button is pressed. - Converts the default US weight and temperature quantities and units in the story into UK equivalents if the UK radio button is checked before the generate button is pressed. -- Generates a new random silly story everytime the button is pressed. +- Generates a new random silly story every time the button is pressed. The following screenshot shows an example of what the finished program should output: diff --git a/files/en-us/learn/javascript/objects/basics/index.md b/files/en-us/learn/javascript/objects/basics/index.md index 8cd7620c89485b0..351396d4c4fecb3 100644 --- a/files/en-us/learn/javascript/objects/basics/index.md +++ b/files/en-us/learn/javascript/objects/basics/index.md @@ -177,7 +177,7 @@ person['name']['first'] This looks very similar to how you access the items in an array, and it is basically the same thing β€” instead of using an index number to select an item, you are using the name associated with each member's value. It is no wonder that objects are sometimes called **associative arrays** β€” they map strings to values in the same way that arrays map numbers to values. -Dot notation is generally preferred over bracket notation because it is more succint and easier to read. +Dot notation is generally preferred over bracket notation because it is more succinct and easier to read. However there are some cases where you have to use brackets. For example, if an object property name is defined at runtime then you can't use dot notation to access the value, but you can pass the name as a variable inside brackets as shown with `input` below: @@ -188,6 +188,7 @@ const person = { } const input = prompt('Get name or age?') console.log(person[input]) +``` ## Setting object members diff --git a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/angular_getting_started/index.md b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/angular_getting_started/index.md index e88c90e4d0ad049..90e370d7e8f8441 100644 --- a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/angular_getting_started/index.md +++ b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/angular_getting_started/index.md @@ -118,14 +118,14 @@ To install Angular on your local system, you need the following: You can use the Angular CLI to run commands in your terminal for generating, building, testing, and deploying Angular applications. To install the Angular CLI, run the following command in your terminal: -```js +```bash npm install -g @angular/cli ``` Angular CLI commands all start with `ng`, followed by what you'd like the CLI to do. In the Desktop directory, use the following `ng new` command to create a new application called `todo`: -```js +```bash ng new todo --routing=false --style=css ``` @@ -137,13 +137,13 @@ If you are prompted to enforce stricter type checking, you can respond with yes. Navigate into your new project with the following `cd` command: -```js +```bash cd todo ``` To run your `todo` application, use `ng serve`: -```js +```bash ng serve ``` diff --git a/files/en-us/mdn/about/index.md b/files/en-us/mdn/about/index.md deleted file mode 100644 index 2f19e938d28fc2a..000000000000000 --- a/files/en-us/mdn/about/index.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: About MDN Web Docs -slug: MDN/About -tags: - - Collaborating - - Community - - Copyright - - Documentation - - Guide - - Licenses - - MDN Meta ---- -{{MDNSidebar}} - -MDN Web Docs (previously known as MDN β€” the Mozilla Developer Network) is an evolving learning platform for Web technologies and the software that powers the Web, including [CSS](/en-US/docs/Web/CSS), [HTML](/en-US/docs/Web/HTML), and [JavaScript](/en-US/docs/Web/JavaScript). We also have a detailed set of beginner's learning material β€” see [Learn Web development](/en-US/docs/Learn). - -## Using MDN Web Docs content - -MDN's content is available free of charge, and under open source licenses. - -### Copyrights and licenses - -MDN's content is entirely available under various open source licenses. This section covers the types of content we provide and what licenses are in effect for each. - -#### Documentation and articles - -> **Note:** MDN content has been prepared with the contributions of authors from both inside and outside Mozilla. Unless otherwise indicated, the content is available under the terms of the [Creative Commons Attribution-ShareAlike license](https://creativecommons.org/licenses/by-sa/2.5/) (CC-BY-SA), v2.5 or any later version. - -When reusing MDN content, you need to ensure two things: - -1. Attribution is given to the original content. - - Please attribute "Mozilla Contributors" and include a hyperlink (online) or URL (in print) to the specific wiki page for the content being sourced. For example, to provide attribution for this article, you can write: - - > [About MDN](/en-US/docs/MDN/About) by [Mozilla Contributors](/en-US/docs/MDN/About/contributors.txt) is licensed under [CC-BY-SA 2.5](https://creativecommons.org/licenses/by-sa/2.5/). - - Note that in the example, "Mozilla Contributors" links to the history of the cited page. See [Best practices for attribution](https://wiki.creativecommons.org/wiki/Marking/Users) for further explanation. - -2. Your reuse is published under the same license as the original contentβ€”CC-BY-SA v2.5 or any later version. - -#### Code samples and snippets - -Code samples added on or after August 20, 2010 are in the [public domain](https://creativecommons.org/publicdomain/zero/1.0/) ([CC0](https://creativecommons.org/publicdomain/zero/1.0/)). No licensing notice is necessary, but if you need one, you can use: "Any copyright is dedicated to the Public Domain. http\://creativecommons.org/publicdomain/zero/1.0/". - -Code samples added before August 20, 2010 are available under the [MIT license](https://opensource.org/licenses/mit-license.php); you should insert the following attribution information into the MIT template: "Β© \ \". - -Since the launch of the new Yari MDN platform on December 14 2020, there is currently no way to determine which one you need. We are working on this and will update this content soon. - -#### Contributions - -If you wish to contribute to this wiki, you must make your documentation available under the Attribution-ShareAlike license (or occasionally an alternative license already specified by the page you are editing), and your code samples available under [Creative Commons CC-0](https://creativecommons.org/publicdomain/zero/1.0/) (a Public Domain dedication). Adding to this wiki means you agree that your contributions will be made available under those licenses. - -Some older content was made available under a license other than those described above; these are indicated at the bottom of each page by way of an _Alternate License Block_. - -> **Warning:** No new pages may be created using alternate licenses. - -**Copyright for contributed materials remains with the author unless the author assigns it to someone else**. - -If you have any questions or concerns about anything discussed here, please contact [the MDN administrators](mailto:mdn-admins@mozilla.org?subject=MDN%20licensing%20question). - -#### Logos, trademarks, service marks and wordmarks - -The rights in the trademarks, logos, and service marks of the Mozilla Foundation, as well as the look and feel of this website, are not licensed under the Creative Commons license, and to the extent they are works of authorship (like logos and graphic design), they are not included in the work that is licensed under those terms. If you use the text of documents, and wish to also use any of these rights, or if you have any other questions about complying with our licensing terms for this collection, you should contact the Mozilla Foundation here: [licensing@mozilla.org](mailto:licensing@mozilla.org "mailto:licensing@mozilla.org"). - -### Linking to MDN - -We regularly get users asking us questions about how to link to MDN, or even if doing so is allowed. The short answer is: **yes, you can link to MDN!** Not only is the hypertext link the essence of the Web, it is both a way to point your users to valuable resources and a show of trust toward the work our community does. diff --git a/files/en-us/mdn/contribute/howto/create_and_edit_pages/index.md b/files/en-us/mdn/contribute/howto/create_and_edit_pages/index.md deleted file mode 100644 index f99f0658eb96102..000000000000000 --- a/files/en-us/mdn/contribute/howto/create_and_edit_pages/index.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: How to create and edit pages -slug: MDN/Contribute/Howto/Create_and_edit_pages -tags: - - Beginner - - Guide - - Howto - - Intro - - MDN Meta ---- -{{MDNSidebar}} - -This article introduces new contributors to the process of editing existing pages and creating new ones. - -## Editing an existing page - -To edit a page, you need to find the page source in our [content](https://github.com/mdn/content) repo. The easiest way to find it is to navigate to the page you want to edit, go to the bottom of the page, and click on the "Source on GitHub" link. - -Once you've found the source to edit, go to our README and work through our [Making contributions](https://github.com/mdn/content#making-contributions) guide. - -### Preview changes - -If you are editing the page locally, to see what your changes look like you can go to the content repo folder, execute the CLI command `yarn start`, go to `localhost:5042` in your browser, and navigate to page and view it. Enter the title in the search box to find it easily. The previewed page will update in the browser live as you edit the source. - -### Tags - -You can add or remove tags, which describe the page's content and purpose, in the "tags" list at the top of the page source. See [How to properly tag pages](/en-US/docs/MDN/Contribute/Howto/Tag), for information on which tags to apply. - -### Attach files - -To attach a file to your article, you just need to include it in the same directory as the article's `index.html` file, and include it in your page, typically via an `` element. - -## Creating a new page - -To create a new page, see our [Adding a new document](https://github.com/mdn/content#adding-a-new-document) instructions. - -## See also - -- [MDN style guide](/en-US/docs/MDN/Guidelines/Writing_style_guide) diff --git a/files/en-us/mdn/contribute/howto/write_for_seo/index.md b/files/en-us/mdn/contribute/howto/write_for_seo/index.md deleted file mode 100644 index 6e90448079f699f..000000000000000 --- a/files/en-us/mdn/contribute/howto/write_for_seo/index.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: How to write with SEO in mind on MDN Web Docs -slug: MDN/Contribute/Howto/Write_for_SEO -tags: - - Contributing to MDN - - Documentation - - MDN - - MDN Meta - - MDN Web Docs - - SEO - - Search Engine Optimization ---- -{{MDNSidebar}} - -This guide covers our standard practices, recommendations, and requirements for content to help ensure that search engines can easily categorize and index our material in order to ensure that users can easily reach what they need. - -## Introduction - -While the primary goal of any writing on MDN should always be to explain and inform about open web technology so developers can quickly learn to do what they want, or to find the little details they need to know in order to perfect their code, it's important that they be able to _find_ the material we write. - -Since most readers reach content on MDN through search engines, as writers, we have to keep that in mind while we work. To do that, we are establishing a selection of "SEO guidelines," to help writers and editors on MDN ensure that each page they work on is reasonably well designed, written, and marked up to give search engines the context and clues they need to properly index articles. - -## SEO checklist - -The following is a list of things you should check while writing and reviewing content to help ensure that the page and its neighbors will be indexed properly by search engines. - -- Make sure the page's contents are [different enough from other pages](#ensure_pages_aren't_too_similar) that search engines don't assume they're about the same thing. -- [Avoid pages that are too short](#avoid_pages_that_are_too_short). Articles that are too short (called "thin pages" in SEO parlance) are difficult to catalog accurately. Whenever possible, pages on MDN should avoid being shorter than around 300 words or so. - -## Ensure pages aren't too similar - -Each article should be as unique as possible. Articles that look similar to one another textually will wind up being considered to be about roughly the same thing, even if they aren't. For example, if an interface has the properties `width` and `height`, it's easy for the text to be surprisingly similar, with just a few words swapped out, and using the same example. This makes it hard for search engines to know which is which, and they wind up sharing page rank, resulting in both being harder to find than they ought to be. - -Understandably, writers confronted with two related properties like `width` and `height` (or any other set of functionally related features) are tempted to write the article on `width`, then copy that article and paste it into the one on `height`, replacing a few words. Done! - -Unfortunately, the result is two pages that, as far as search engines are concerned, may as well be the same thing. - -It's important, then, to ensure that every page has its own content. Here are some suggestions to help you accomplish that: - -- Consider use cases where there might be more differences than one would think. For instance, in the case of `width` and `height`, perhaps consider ways horizontal space and vertical space are used differently, and provide a discussion about the appropriate concepts. Perhaps you mention the use of width in terms of making room for a sidebar, while using height to handle vertical scrolling or footers or similar. Including information about accessibility issues is a useful and important idea as well. -- Use entirely different examples on each page. Examples in these situations are often even more similar than the body text, since the examples may use both (or all) of the similar methods or properties to begin with, thereby requiring no real changes when reused. So throw out the example and write a new one, or at least provide multiple examples, with at least some of them different. -- Include descriptions of each example. Both an overview of what the example does as well as coverage of how it works, in an appropriate level of detail given the complexity of the topic and the target audience, should be included. - -The easiest way to avoid being overly similar is of course to write each article from scratch if time allows. - -## Avoid pages that are too short - -Articles that are too short (called "thin pages" in SEO parlance) are difficult to catalog accurately. Whenever possible, pages on MDN should avoid being shorter than around 300 words or so. Here are some basic guidelines to help you create pages that have enough content to be properly searchable without resorting to cluttering them up with unnecessary text. - -- Obviously, if the article is a stub, or is missing material, add it. We try to avoid outright "stub" pages on MDN, although they do exist, but there are plenty of pages that are missing large portions of their content. -- Generally review the page to ensure that it's structured properly for the [type of page](/en-US/docs/MDN/Structures/Page_types) it is. Be sure every section that it should have is present and has appropriate content. -- Make sure every section is complete and up-to-date, with no information missing. Are all parameters listed and explained? Make sure any exceptions are covered (this is a particularly common place where content is missing). -- Be sure everything is fully fleshed-out. It's easy to give a quick explanation of something, but make sure that all the nuances are covered. Are there special cases? Known restrictions that the reader might need to know about? -- There should be examples covering all parameters or at least the parameters (or properties, or attributes) that users from the beginner through intermediate range are likely to use, as well as any advanced ones that require extra explanation. Each example should be preceded with an overview of what the example will do, what additional knowledge might be needed to understand it, and so forth. After the example (or interspersed among pieces of the example) should be text explaining how the code works. Don't skimp on the details and the handling of errors in examples; readers _will_ copy and paste your example to use in their own projects, and your code _will_ wind up used on production sites! See [code examples](/en-US/docs/MDN/Structures/Code_examples) and our [code example guidelines](/en-US/docs/MDN/Guidelines/Code_guidelines) for more useful information. -- If there are particularly common use cases for the feature being described, talk about them! Instead of assuming the reader will figure out that the method being documented can be used to solve a common development problem, actually add a section about that use case with an example and text explaining how the example works. -- Include proper {{htmlattrxref("alt", "img")}} text on all images and diagrams; this text counts, as do captions on tables and other figures, because spiders can't crawl images, and so {{htmlattrxref("alt", "img")}} text tells search engine crawlers what content the embedded media contains. Note: it is not best practice to include too many keywords, or feature unrelated keywords in an attempt to manipulate search engine rankings; this type of behavior is easy to spot and tends to be penalized. -- Likewise, do *not* descend into adding repetitive, unhelpful material, or blobs of keywords within the actual page, in an attempt to improve the page's size and search ranking. This does more harm than good, both to content readability and to our search results. -- With Google's Hummingbird update in 2013, there has been an increasing focus on the use of natural language to convey information. This means that it is far better to write content around the topic of the article, than a specific keyword. It is highly likely that there will be many keywords you could include for a given topic; in fact, many SEOs compile a list of 5-100 different keywords (varying between short, medium, and long-tail keywords) to include within their article, depending on the length. Doing so will diversify your wording, leading to less repetition. - -## See also - -- [Contributing to MDN](/en-US/docs/MDN/Contribute) -- [Writing style guide](/en-US/docs/MDN/Guidelines/Writing_style_guide) diff --git a/files/en-us/mdn/guidelines/code_guidelines/css/index.md b/files/en-us/mdn/guidelines/code_guidelines/css/index.md deleted file mode 100644 index 1799aeb1f0dc2f2..000000000000000 --- a/files/en-us/mdn/guidelines/code_guidelines/css/index.md +++ /dev/null @@ -1,274 +0,0 @@ ---- -title: CSS guidelines -slug: MDN/Guidelines/Code_guidelines/CSS -tags: - - CSS - - Code - - Guide - - Guidelines - - MDN Meta ---- -{{MDNSidebar}} - -The following guidelines cover how to write CSS for MDN code examples. - -## In this article - -- [High-level guidelines](#high-level_guidelines) - - - [Don't use preprocessors](#dont_use_preprocessors) - - [Don't use specific CSS methodologies](#dont_use_specific_css_methodologies) - - [Use flexible/relative units](#use_flexiblerelative_units) - - [Don't use resets](#dont_use_resets) - - [Plan your CSS β€” avoid overriding](/en-US/docs/MDN/Guidelines/Code_guidelines/CSS#plan_your_css_%e2%80%94_avoid_overriding) - -- [General CSS coding style](#general_css_coding_style) - - - [Use expanded syntax](#use_expanded_syntax) - - [Favor longhand rules over terse shorthand](#favor_longhand_rules_over_terse_shorthand) - - [Use double quotes around values](#use_double_quotes_around_values) - - [Spacing around function parameters](#spacing_around_function_parameters) - - [CSS comments](#css_comments) - - [Don't use !important](#dont_use_!important) - -- [Specific CSS syntax points](#specific_css_syntax_points) - - - [Turning off borders and other properties](#turning_off_borders_and_other_properties) - - [Use "mobile first" media queries](#use_mobile_first_media_queries) - -- [Selectors](#selectors) - - - [Don't use ID selectors](#dont_use_id_selectors) - - [Put multiple selectors on separate lines](#put_multiple_selectors_on_separate_lines) - -## High-level guidelines - -### Don't use preprocessors - -Don't use preprocessor syntax, e.g. [Sass](https://sass-lang.com/), [Less](https://lesscss.org/), or [Stylus,](https://stylus-lang.com/) in your MDN example code. MDN documents the vanilla CSS language, and using preprocessors only serves to raise the bar to understanding the examples, potentially confusing readers. - -### Don't use specific CSS methodologies - -In the same spirit as the previous guideline, don't write MDN example code using a specific CSS methodology such as [BEM](http://getbem.com/naming/) or [SMACSS](http://smacss.com/). Even though they are valid CSS syntax, the naming conventions can be confusing to people not familiar with those methodologies. - -### Use flexible/relative units - -For maximum flexibility over the widest possible range of devices, it is a good idea to size containers, padding, etc. using relative units like ems and rems, or percentages and viewport units if you want them to vary depending on viewport width. You can read some more about this in our [Responsive design building blocks](/en-US/docs/Web/Progressive_web_apps/Responsive/responsive_design_building_blocks#fluid_grids) article. - -### Don't use resets - -For maximum control over CSS across platforms, a lot of people used to use CSS resets to remove every style, before then building things back up themselves. This certainly has its merits, but especially in the modern world CSS resets can be overkill, resulting in lots of extra time spent reimplementing things that weren't completely broken in the first place, like default margins, list styles, etc. - -If you really feel like you need to use a reset, consider using [normalize.css by Nicolas Gallagher](https://necolas.github.io/normalize.css/), which aims to just make things more consistent across browsers, get rid of some default annoyances that we always remove (the margins on ``, for example) and fix a few bugs. - -### Plan your CSS β€” avoid overriding - -Before diving in and writing huge chunks of CSS, plan your styles carefully. What general styles are going to be needed, what different layouts do you need to create, what specific overrides need to be created, and are they reusable? Above all, you need to try to avoid too much overriding. If you keep finding yourself writing styles and then cancelling them again a few rulesets down, you probably need to rethink your strategy. - -## General CSS coding style - -### Use expanded syntax - -There are a variety of CSS writing styles you can use, but we prefer the expanded style, with the selector/opening brace, close brace, and each declaration on a separate line. This maximizes readability, and again, promotes consistency on MDN. - -Use this: - -```css example-good -p { - color: white; - background-color: black; - padding: 1rem; -} -``` - -Not this: - -```css example-bad -p { color: white; background-color: black; padding: 1rem; } -``` - -In addition, keep these specifics in mind: - -- Include a space between the selector(s) and the opening curly brace. -- Always include a semi-colon at the end of the last declaration, even though it isn't strictly necessary. -- Put the closing curly brace on a new line. -- In each declaration, put a space after the separating colon, but not before. -- Use 2 spaces for code indentation. - -### Favor longhand rules over terse shorthand - -Usually when teaching the specifics of CSS syntax, it is clearer and more obvious to use longhand properties, rather than terse shorthand (unless of course teaching the shorthand is the point of the example). Remember that the point of MDN examples is to teach people, not to be clever or efficient. - -To start with, it is often harder to understand what the shorthand is doing. It takes a while to pick apart exactly what {{cssxref("font")}} syntax is doing, for example: - -```css -font: small-caps bold 2rem/1.5 sans-serif; -``` - -Whereas this is more immediate in terms of understanding: - -```css -font-variant: small-caps; -font-weight: bold; -font-size: 2rem; -line-height: 1.5; -font-family: sans-serif; -``` - -Second, CSS shorthand comes with potential added pitfalls β€” default values are set for parts of the syntax that you don't explicitly set, which can produce unexpected resets of values you've set earlier in the cascade, or other expected effects. The {{cssxref("grid")}} property for example sets all of the following default values for items that are not specified: - -- {{cssxref("grid-template-rows")}}: `none` -- {{cssxref("grid-template-columns")}}: `none` -- {{cssxref("grid-template-areas")}}: `none` -- {{cssxref("grid-auto-rows")}}: `auto` -- {{cssxref("grid-auto-columns")}}: `auto` -- {{cssxref("grid-auto-flow")}}: `row` -- {{cssxref("column-gap")}}: `0` -- {{cssxref("row-gap")}}: `0` -- {{cssxref("column-gap")}}: `normal` -- {{cssxref("row-gap")}}: `normal` - -In addition, some shorthands only work as expected if you include the different value components in a certain order. In CSS animations for example: - -```css -/* duration | timing-function | delay | iteration-count - direction | fill-mode | play-state | name */ -animation: 3s ease-in 1s 2 reverse both paused slidein; -``` - -As an example, the first value that can be parsed as a [`