diff --git a/.github/workflows/auto-cleanup-bot.yml b/.github/workflows/auto-cleanup-bot.yml index 485f6b7a7207600..620555d775b641a 100644 --- a/.github/workflows/auto-cleanup-bot.yml +++ b/.github/workflows/auto-cleanup-bot.yml @@ -31,6 +31,8 @@ jobs: yarn content fix-flaws yarn fix:md yarn fix:fm + node scripts/sort_and_unique_file_lines.js .vscode/ignore-list.txt + node scripts/sort_and_unique_file_lines.js .vscode/terms-abbreviations.txt - name: Create PR with only fixable issues if: success() diff --git a/.github/workflows/pr-check_cspell_lists.yml b/.github/workflows/pr-check_cspell_lists.yml new file mode 100644 index 000000000000000..a40d41797fd9669 --- /dev/null +++ b/.github/workflows/pr-check_cspell_lists.yml @@ -0,0 +1,33 @@ +name: Check cSpell lists + +on: + pull_request: + branches: + - main + paths: + - .vscode/ignore-list.txt + - .vscode/terms-abbreviations.txt + +jobs: + docs: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + with: + sparse-checkout-cone-mode: false + sparse-checkout: | + .vscode/ignore-list.txt + .vscode/terms-abbreviations.txt + .nvmrc + package.json + scripts/sort_and_unique_file_lines.js + + - name: Setup Node.js environment + uses: actions/setup-node@v4 + with: + node-version-file: ".nvmrc" + + - name: Check if cSpell word lists are in correct order + run: | + node scripts/sort_and_unique_file_lines.js .vscode/ignore-list.txt --check + node scripts/sort_and_unique_file_lines.js .vscode/terms-abbreviations.txt --check diff --git a/.github/workflows/spelling-check-bot.yml b/.github/workflows/spelling-check-bot.yml index cc04cb4776acc40..f8eacc8444f979d 100644 --- a/.github/workflows/spelling-check-bot.yml +++ b/.github/workflows/spelling-check-bot.yml @@ -44,7 +44,7 @@ jobs: env: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} TITLE: Weekly spelling check - LABELS: reported by automation,good first issue + LABELS: reported by automation BODY: | Typos and unknown words: diff --git a/.lintstagedrc.js b/.lintstagedrc.js index 4204b0b0beb4f16..decfb9664873fbd 100644 --- a/.lintstagedrc.js +++ b/.lintstagedrc.js @@ -17,4 +17,10 @@ export default { `yarn filecheck ${filenames.join(" ")}`, ], "*": (filenames) => [`node scripts/log-url-issues.js`], + ".vscode/ignore-list.txt": (filenames) => [ + `node scripts/sort_and_unique_file_lines.js .vscode/ignore-list.txt`, + ], + ".vscode/terms-abbreviations.txt": (filenames) => [ + `node scripts/sort_and_unique_file_lines.js .vscode/terms-abbreviations.txt`, + ], }; diff --git a/.vscode/ignore-list.txt b/.vscode/ignore-list.txt index 8910def71fe49c5..80797e93d6c6a44 100644 --- a/.vscode/ignore-list.txt +++ b/.vscode/ignore-list.txt @@ -1,257 +1,19 @@ -aaabcc -aabaac -aacbbbcac -ACCEPTEDTOS -accname -adduser -adjtimescapheight -adjtimesexheight -adrianroselli -advertisementreceived -aggregatable -alastairc -alistapart -ALLOWFROM -alphanumerals -Animometer -Annonay -antialiasing -apacheconf -apachectl -ASCIIID -assetlinks -audiocontext -beforeinstallpromptevent -beforetoggle -belgin -blockable -brians -Browsersync -browsingtopics -bytestring -CACHEDIR -catchable -Caterina -characterboundsupdate -Cheatsheet -checkboard -checkmarks -clipboardchange -Codelab -collectability -collinearity -concatenator -contenido -contentlost -contentscripts -contentvisibilityautostatechange -controlbar -cookieless -cooluser -crashextensions -credentialled -crookedtimber -cssgridgarden -csstricks -Cubehelix -cubemaps -currentscreenchange -customstateset -cycletracker -davidwalsh -demuxing -Descripton -dropshow -enablei -Engish -Ethere -everytime -evilsite -examplestyles -Fairchild -fencedframe -fencedframeconfig -fencedframes -filetext -filterfunctions -Flagfox -forwidth -gattserverdisconnected -generatable -GETMATCHEDRULES -givenname -greenblue -greenzero -growshrink -harpercollins -highspeed -imagebad -imagegrid -infobox -infoboxes -infobox's -innertext -interarrival -ipados -jamiedoe -Jinping -Kobabe -lazyloaded -letmein -lightpurple -Lindenberg -linecaps -longwinded -loopstarted -lowdelay -macaron -Malala -mathit -maxplaybackrate -megastore -metastring -miplevel -Miroslav -Misparsed -modulepreloaded -montecarlo -mouseentry -multifactor -multimemory -mygroupmarker -mysampler -mystatename -navigables -nextslide -Nodepad -noteblocks -notrendered -Nowrapping -offsetted -ontextformatupdate -ontextupdate -pagereveal -pageswap -paintable -paintsize -papermakers -permissionspolicy -pipline -Platformer -playbackrate -popovertarget -popovertargetaction -precache -precached -precaches -precaching -preconnects -preloaders -premultiplication -prerenderingchange -prerenders -previousslide -pricelist -properities -pythonanywhere -pythonaware -rawupdate -readonlyinline -realpython -redblue -redyellow -redzero -requireinteraction -reselecting -Resizeable -resnapped -Ronaldo -rtctransform -samplepay -scanability -screenreaders -screenschange -seecompattable -selectchange -selectedness -Serpentina -shadowrootdelegatesfocus -shadowrootmode -shadowrootserializable -sharedmem -sharpyuv -shortlinks -shrinkwap -shrinkwrapping -sinkchange -smashingmagazine -Snapshotting -somestate -srihash -stackexchange -Stormys -Stratford -styleable -subformula -subformulas -subheaders -subpattern -subpopover -subproject -Subsentence -subsetting -subteam -subteams -sunsetting -supersets -swashoff -targettable -textformatupdate -textupdate -timeframe -truthyness -tunetheweb -tutsplus -underliner -underlyingly -usecase -useinbandfec -valuechange -viewbox -virtualkeyboardpolicy -webappmanifest -webbundle -webcodecs -webdav -webdesignerdepot -webidentity -webtransport -whitepoint -wisedog -workgroups -writingsuggestions -zeroblue -zeroyellow -zerozero -Amit -Scrimba -rvfc -Azarath -Tamaran AAAAAAABAAE AAAAD AAABAAEAEBAAA +aaabcc aaba +aabaac AABB +AABB's aabbcc aabbccdd -AABB's +aacbbbcac AAEC AAFEI AAGUID AAQAB aarch -Áaron abaac Ababa ABAQ @@ -300,10 +62,12 @@ accentlightesthighlight accentlightshadow accentregularhighlight accentregularshadow +ACCEPTEDTOS Accessibilità Accessibles accesskeys acclmtr +accname accountnum accu accumsan @@ -316,9 +80,7 @@ achromatopsia acknowl acknowled acodec -𝚊𝚌𝚘𝚜 acosh -𝚊𝚌𝚘𝚜𝚑 Acrosync ACSS activatable @@ -333,6 +95,7 @@ addressbar addsourcebuffer addstream addtrack +adduser Addy ADHD Adilah @@ -341,16 +104,19 @@ adipiscing adipisicing adipscing adjtimes +adjtimescapheight +adjtimesexheight Adlam adlm ADPCM +adrianroselli ADSR adtech +advertisementreceived AEDT aeio AEIOU aeiouy -ˈælfa Aenean AEST afes @@ -363,6 +129,7 @@ afterprint afterscriptexecute afunkydomainname agere +aggregatable aggregately Agnostify AGWG @@ -370,6 +137,7 @@ Ahom AIAAAA Akhgari ALAC +alastairc alaw albumicon Alem @@ -387,6 +155,7 @@ aliquid aliquip aliquyam alispivak +alistapart ality allbooks ALLCAPS @@ -394,10 +163,12 @@ Allons allowdirs allowdropevent allowevents +ALLOWFROM ALLPASS allsettled allsmallcaps Alman +alphanumerals alphatransparency ALPN alternatingbackground @@ -407,6 +178,7 @@ ambisonic Amet Amete Amiri +Amit Amit's amore Amorim @@ -420,10 +192,10 @@ analyser's analyzability anana Anand -André Andreas Andreessen Andrzej +André Anek angleminus ANGLETYPE @@ -435,7 +207,9 @@ animationend animationiteration animationstart animi +Animometer ANMF +Annonay annunaki anonid Anonymization @@ -445,11 +219,14 @@ anotherscript anothertarget Ansari Ansyari +antialiasing antitracking Anurag anyfunc anypage Anytown +apacheconf +apachectl Apapou APCA aperiam @@ -508,18 +285,18 @@ Arun Asana ASCAP ascendingly +ASCIIID Asclepias ASGI Ashita Ashlyn Ashok's -𝚊𝚜𝚒𝚗 asinh -𝚊𝚜𝚒𝚗𝚑 asintn ASLR asmo Assemblée +assetlinks associationlist associationlistitemkey associationlistitemvalue @@ -529,10 +306,8 @@ asuintn asynchrony asynciterator ATAG -𝚊𝚝𝚊𝚗 Atanassov atanh -𝚊𝚝𝚊𝚗𝚑 atexits atlasing Atmark @@ -545,6 +320,7 @@ Attributs Attrx auctor Audiocogs +audiocontext audioend Audiofile audioinput @@ -603,6 +379,7 @@ Axess AXQB Aylin Ayşe +Azarath Azeri AZERTY Aziz @@ -655,12 +432,15 @@ beforeend beforeevicted beforeinput beforeinstallprompt +beforeinstallpromptevent beforematch beforeprint beforescriptexecute +beforetoggle beforeunload beforexrselect Beihang +belgin belowbreve belowcircumflex belowcomma @@ -677,8 +457,6 @@ Bernouilli beststartupever Beverloo's Bezier -Bézier -Béziers bezje bfalse bfcache @@ -736,6 +514,7 @@ blit blitting blobconstructor Blobular +blockable blockified blockiness blocklists @@ -788,13 +567,13 @@ Boxrender boxtitle BPPV BPTC -ˈbraːˈvo braceless brah Brai braillelabel brailleroledescription bram +brians brickfield brighttext Broadcastchannel @@ -804,7 +583,9 @@ browserless Browsershots browserslistrc BROWSERSTACK +Browsersync browsertabbar +browsingtopics Bruant brucelindbloom BSAC @@ -843,11 +624,15 @@ byterange byteranges bytestream Bytestreams +bytestring +Bézier +Béziers caaaaaaandy caaandy caandy Cachable Cacheable +CACHEDIR CAFEBABE CAIND caitmuenster @@ -886,6 +671,8 @@ Cassini caststatus Català Catan +catchable +Caterina catfishhead catflap catfront @@ -898,7 +685,6 @@ CBDT CBJS CBOR cbrt -𝚌𝚋𝚛𝚝 ccall CCITT CCPA @@ -907,7 +693,6 @@ cdbbdbsbz CDLR cdylib Ceci -Célestes cellhighlight cellhighlighttext CELP @@ -921,6 +706,7 @@ Chakra Chakra's Chamakh changeme +characterboundsupdate characteristicvaluechanged characterset charat @@ -933,10 +719,13 @@ chatbox chatserver chbox chbx +Cheatsheet +checkboard checkedness checkiandj checkin checkj +checkmarks checkmenuitem Chiki childlist @@ -986,6 +775,7 @@ clienthello clientkey clig clike +clipboardchange Clippy clipspace cliptext @@ -996,8 +786,8 @@ cloneable closebutton closeme Cloudinary -Clóvis CLREQ +Clóvis CMAMBAAAAAA CMYK cndy @@ -1008,6 +798,7 @@ codebases Codecademy Codedread Codeinput +Codelab codementor CODEOWNERS codepaths @@ -1028,8 +819,10 @@ colex colexographical colindextext collapser +collectability Collectn collectstatic +collinearity Colomb colorbox colorchange @@ -1065,6 +858,7 @@ compositionend compositionstart compositionupdate CONCAT +concatenator Cond Conde Condei @@ -1091,22 +885,29 @@ consetetur Consolas constructio Containerless +contenido contentaccessible contentarea contentdelete Contentful +contentlost +contentscripts contenttypes +contentvisibilityautostatechange contentvisibilityautostatechanged contextlost contextrestored +controlbar controllerchange controlslist conubia convallis Convolutional cookiechange +cookieless coolexample coolmodule +cooluser Coprime copysign copywithin @@ -1115,9 +916,7 @@ CORB Corber CORSM Cortana -𝐜𝐨𝐬 COSE -𝚌𝚘𝚜𝚑 couleur countername Coursera @@ -1129,16 +928,18 @@ cpuworker cqmax cqmin Cras +crashextensions Cratchit crbug createpattern createreader createsuperuser +credentialled Credentialless -crédit creds cript Crockford +crookedtimber cros crossbrowser crossdomain @@ -1148,6 +949,7 @@ cryptokey CRYPTOMINING cryptosystem cryptosystems +crédit csbig Cscript cseuckr @@ -1170,6 +972,7 @@ csscomputed cssdb cssfontstack cssgrid +cssgridgarden cssgridlegacy csshiftjis cssinfo @@ -1182,6 +985,7 @@ cssremedy cssruleview csssubgrid csssyntax +csstricks cssvisual CSSWG CSSX @@ -1193,7 +997,9 @@ ctlr ctron ctrz ctypes +Cubehelix cubemap +cubemaps cubetexture cubilia cuechange @@ -1206,15 +1012,19 @@ Curlz curr currentcolor currententrychange +currentscreenchange cursus Curveto CUSEL customelements customshapes +customstateset CWND cwrap Cyberduck +cycletracker Cylon +Célestes DAAA daala dafont @@ -1246,6 +1056,7 @@ datetimeformat datetimes Datumizer davbrito +davidwalsh davidwalshblog dbbd DBFF @@ -1280,17 +1091,16 @@ delectus deleniti deleteoperator deleteproperty -ˈdeltɑ Demi -démonstration demozilla demultiplexing demux +demuxing Denicola Denicola's Deno -denormalized Deno's +denormalized deoptimize depreceted deprioritized @@ -1305,6 +1115,7 @@ Desaulniers descendingly descr descript +Descripton deserunt desinis Desproges @@ -1471,6 +1282,7 @@ Dreamweaver dropevent dropmarker dropshadow +dropshow droptarget DSCP DSLs @@ -1498,6 +1310,7 @@ Dyno Dynos dyscalculia Dyslexi +démonstration Eader EAEFF Ealert @@ -1555,7 +1368,6 @@ elot elts emailme emailoptin -Émanuel embeddable Embedder Embedders @@ -1572,6 +1384,7 @@ Emptytext EMSCRIPTEN Emscripting emsdk +enablei Encod encodeuri encodeuricomponent @@ -1586,6 +1399,7 @@ Endtest endtime engageability engageable +Engish enim ENLW ENOENT @@ -1630,6 +1444,7 @@ Esta Etag etags Etarget +Ethere ethertank ethi ethioaa @@ -1642,6 +1457,8 @@ eveniet evenodd eventname eventtarget +everytime +evilsite Examp examplebutton examplecheckbox @@ -1665,6 +1482,7 @@ exampleradio examplerange examplereset examplesearch +examplestyles examplesubmit exampletel exampletext @@ -1681,11 +1499,9 @@ Exfiltration EXIF exitpictureinpicture Exljbris -𝚎𝚡𝚙 Expando expedita expm -𝚎𝚡𝚙𝚖 expressjs expresstests exprgen @@ -1716,6 +1532,7 @@ factfile factit Factsheet failovers +Fairchild fakeid fakepath falsey @@ -1743,6 +1560,9 @@ fedcm feedforward FEFD felis +fencedframe +fencedframeconfig +fencedframes feoffset fermentum fers @@ -1769,9 +1589,11 @@ filesharing filesize filestream Filesystems +filetext Filezilla FILLMODE fillstyle +filterfunctions filteron fina finalizer @@ -1803,13 +1625,14 @@ flabada FLAC FLAC's flagcolors +Flagfox flashtext flatmap Flavio fleurons Flexbox -Flexboxes flexbox's +Flexboxes Flexbugs flexy Flickr @@ -1868,6 +1691,7 @@ forof Fortnite Forw forwardonly +forwidth FOSS Foti FOUC @@ -1908,8 +1732,8 @@ fromentries frontmatter frontmost fround -Früh fruitbear +Früh Fscreen Fscript fugiat @@ -1969,6 +1793,7 @@ gangnam Gannen gatheringstatechange Gato +gattserverdisconnected Gayatri Gbps GCLI @@ -1980,6 +1805,7 @@ geckoversion geckoview Gedit gement +generatable generix geng geolocate @@ -1991,11 +1817,11 @@ geor GEOSTD GEQUAL Gerd -GESÄSS -Gesäß gesturechange gestureend gesturestart +GESÄSS +Gesäß getbigint getbiguint getcanonicallocales @@ -2007,6 +1833,7 @@ getfloat getfullyear gethours getint +GETMATCHEDRULES getmilliseconds getminutes getmonth @@ -2039,6 +1866,7 @@ Gillenwater's gims giphy Gitbash +givenname glanceable Glat glcanvas @@ -2076,9 +1904,11 @@ graylevel Grayscale Grayscaling Graywolf +greenblue Greenify Greensock greentoggle +greenzero grek greklow greon @@ -2101,6 +1931,7 @@ groupbytomap groupingoperator groupname growsandstays +growshrink GSAP GSSAPI Gstreamer @@ -2117,7 +1948,6 @@ gzipped Gzipping Gzzh habitasse -háček halehame HALFWIDTH Halloumi @@ -2136,6 +1966,7 @@ HANKAKU hansfin hantfin harissa +harpercollins harum Hashbang hashchange @@ -2189,6 +2020,7 @@ HIGHPASS highres Highrise HIGHSHELF +highspeed Hijri Hildy hilite @@ -2226,7 +2058,6 @@ Holzman Homescreen homothetic Honigswald -Hönigswald hoosteeno horizontalstrike horzvert @@ -2291,7 +2122,8 @@ Hyperaudio's hyperlinktext hypertexts hypot -𝚑𝚢𝚙𝚘𝚝 +háček +Hönigswald iaculis iarc ICAI @@ -2383,7 +2215,9 @@ Ilter Ilya imag imageattr +imagebad imagedata +imagegrid imagemaps IMAGESET imageurl @@ -2396,8 +2230,8 @@ impedit imperdiet importmap IMSC -imscjs IMSC's +imscjs imul inactivetitlebarcolor inceptos @@ -2409,6 +2243,9 @@ indexeddb indexof infile infobar +infobox +infobox's +infoboxes inga initialimage Initialise @@ -2418,6 +2255,7 @@ Inkscape's inlinable Inlines innerht +innertext innolitics inoperator inputdevices @@ -2441,6 +2279,7 @@ Intelli Intellifont Interactability interactable +interarrival interceptable intercooler Interdimensional @@ -2462,6 +2301,7 @@ invidunt Invision Ionos ipaddr +ipados IPFS ipns ipsa @@ -2522,6 +2362,7 @@ iyqi Jaenisch Jalad Jalkhov +jamiedoe Jank janking Jankord @@ -2539,7 +2380,6 @@ Jehl's Jeni's Jeonja Jeremie -Jérémie jeremiepat Jewett jfgd @@ -2547,7 +2387,7 @@ JFIF jgndmic jhokmfdskl jibbering -jícama +Jinping JISHO Jitsi Jjom @@ -2596,16 +2436,18 @@ jswebm jsxref jumpless jumpterm -Júnior JUNJA justo justone juxtaposi JXON +Jérémie +jícama +Júnior Kadir Kadlec -kaios Kahlo +kaios Kakao Kaku Kaply @@ -2677,6 +2519,7 @@ Kneeland Knocky Knolwedgement Knowbility +Kobabe Kokoro Kolkata kombu @@ -2691,9 +2534,12 @@ Kravets Kulikov KUMA kumascript -Kütük kwargs Kyouko +Kütük +L'homme +l'oignon +l'âge labelable labeledby labore @@ -2702,7 +2548,6 @@ laboris laborum lacinia lacus -l'âge Lagerblad laggy Laing @@ -2731,6 +2576,7 @@ laudatur Lauke lazify lazyload +lazyloaded lazysizes Lbitfield Lclampf @@ -2754,13 +2600,12 @@ Lempel LENGTHADJUST LENGTHTYPE Lennart -Léonie -Léonie's leopardskin lepc Lepcha LEQUAL Lesh +letmein letterboxed letterboxing letterform @@ -2770,7 +2615,6 @@ levelchange levent Lexi Leyla -L'homme Lianghekou Libav Libertinus @@ -2787,16 +2631,19 @@ liga Lightbox lightgoldenrod lightnesses +lightpurple lightshow Lighttpd Limbu Limin Lindbloom's +Lindenberg Lindesay lineargradient Linearize lineboundary linebreak +linecaps linename Lineto linewidth @@ -2820,7 +2667,6 @@ Llanfair LLLLLLLLLLLLLLLLRRRRRRRRRRRRRRRR LMENU lmodern -𝙻𝙽 lname lnum loadeddata @@ -2847,12 +2693,9 @@ localtime locationbar lockscreens lofi -𝚕𝚘𝚐 -𝙻𝙾𝙶 logarithmed logline Logpoints -l'oignon longdiv longhands longspan @@ -2860,15 +2703,18 @@ longtask longtasks Longterm longwave +longwinded Lookaheads lookbehinds loopend loopstart +loopstarted Losslessly lostcapture lostpackets lostpointercapture Lovie +lowdelay lowlights lowp LOWPASS @@ -2900,6 +2746,9 @@ lvmax lvmin LWIN lwtheme +Léonie +Léonie's +macaron Macarons Machrek Macknik @@ -2924,6 +2773,7 @@ Majestatis Majumdar makemigrations Makey +Malala malesuada malloc Mamitiana @@ -2943,7 +2793,6 @@ MARKERUNITS Markmarkimark Martell martinfowler -März Masaram Masayuki Maski @@ -2951,11 +2800,11 @@ MASSHOU Massieux matchall MATF -𝙼𝚊𝚝𝚑 mathbb mathbold mathdbl mathfont +mathit MATHML mathmono Mathoid @@ -2977,6 +2826,7 @@ maxgreen maxime Maximiliano maximus +maxplaybackrate maxrow maxsafeinteger maxvalue @@ -3002,6 +2852,7 @@ mediump Medline Meetei MEETORSLICE +megastore Meggin meinheld memcpy @@ -3034,6 +2885,7 @@ messagebox messageerror Metafile metalness +metastring meterbar meterchunk METHODTYPE @@ -3075,16 +2927,19 @@ minimalistic minmax minuto minutos +miplevel MIPMAP mipmapped Mipmapping Mipmaps Miracast +Miroslav mirrorable mirunacurtean misissuance misissuances misissued +Misparsed mitigations MITM Mitzie @@ -3108,6 +2963,7 @@ Moderna Modernizr Modernizr's Modif +modulepreloaded Moin Moiré Mojibake @@ -3122,6 +2978,7 @@ momot monkeypatch monoscopic Montag +montecarlo moof Moonrocks Mooog @@ -3135,6 +2992,7 @@ Mork morx Mothman MOUSEDOWN +mouseentry MOUSEHWHEEL mouseleave mouselook @@ -3192,13 +3050,14 @@ MUAT Mufasa MUHENKAN Mullany -Müller mult Multicol multicolumn multicolumns multicore +multifactor multihomed +multimemory multimessaging multipage multipass @@ -3218,12 +3077,12 @@ Multiview Mundo Munsell muscaria -Musée musicdsp Musicogenic musicplayer Musicr Mustafa +Musée MVVM myaddon MYAGE @@ -3263,6 +3122,7 @@ myfoot myform myframe mygraphic +mygroupmarker myhead myhost myid @@ -3303,12 +3163,14 @@ myrenderpassencoder myrenderpipeline myroutine myrows +mysampler myscript myserver myshader myshov mysprite mystate +mystatename mystring mystunserver mystylesheet @@ -3328,10 +3190,11 @@ myview myweb mywindow myworkerurl +März +Müller Nacl Nada Naeher -naïvely Nakamura Nakano's Nally @@ -3348,11 +3211,13 @@ nativehyperlinktext natoque natus Navara +navigables navigateerror navigatesuccess Navigations -Nazário Nazarrudin +Nazário +naïvely NCBI NCLX ndata @@ -3397,6 +3262,7 @@ newtab newtarget newtext newval +nextslide nextstep NEXTTRACK nextul @@ -3405,9 +3271,9 @@ NFKC NFKD nguy nibh +NIC's nicezero nicht -NIC's niform nightlies nightwatch @@ -3422,6 +3288,7 @@ nobis nobooks nobullets nocache +Nodepad nodeset nodownload noemit @@ -3463,6 +3330,7 @@ notanaudio Notar notaurl notavideo +noteblocks notebox notecard notfound @@ -3471,11 +3339,13 @@ notificationbox notificationclick notificationclose Noto +notrendered notservice NOTSUPPORTEDERR nourl nowledge nowledgement +Nowrapping NPAPI npmjs NPNVDOM @@ -3525,6 +3395,7 @@ offmainthreadcomposition offscreencanvas offsetblur offsetleft +offsetted oggz Ogonek OIDC @@ -3579,6 +3450,8 @@ onscreenschange onscrollend onsinkchange ontent +ontextformatupdate +ontextupdate ontrol onum onuncapturederror @@ -3630,7 +3503,6 @@ osma Osmani Osmani's Osmanya -Österreich otation othercompany otherdoc @@ -3678,15 +3550,19 @@ pageinfo Pagella pageload pageloadtime +pagereveal pageshow -páginas +pageswap Pahawh +paintable +paintsize paintworklet paintworklet's pais Palatino Paletton pantherina +papermakers paragraaf paragraphboundary paragraphe @@ -3738,8 +3614,8 @@ Pedestaling peerconnection peerjs Pelientesque -Pellentesque Pell's +Pellentesque Penadés penatibus Pereira @@ -3749,6 +3625,7 @@ periodicsync perispomeni Perlin permessage +permissionspolicy pers personalbar personaltoolbar @@ -3769,7 +3646,6 @@ phonorecords photopic Photoshop PHPSESSID -𝙿𝙸 Picryl Picturefill PIDOM @@ -3783,6 +3659,7 @@ Pinia PINP Pinterest Piotrek +pipline Pissuti Pitstop Pixabay @@ -3794,9 +3671,11 @@ placeat placerat Platane platea +Platformer platformers platformversion playbackorder +playbackrate playbackspeed playbutton playcanvas @@ -3846,6 +3725,8 @@ pomm pomr popcnt popout +popovertarget +popovertargetaction popstate populatedb popuponclick @@ -3874,7 +3755,6 @@ potappo potenti potl potr -𝚙𝚘𝚠 Powerbook powerefficient Powermapper's @@ -3886,9 +3766,14 @@ Praesent pranswer Prateek preactivate +precache +precached +precaches +precaching precoded Precomposed preconnecting +preconnects predeclared preffed prefixless @@ -3900,7 +3785,9 @@ prefwindow preg preinstall prelighting +preloaders premkproject +premultiplication PREMULTIPLY preorder prepopulate @@ -3911,9 +3798,10 @@ preprocessors Prerender prerendered prerendering +prerenderingchange +prerenders preresolved presentationml -présenté PRESERVEASPECTRATIO presnap pressable @@ -3925,9 +3813,11 @@ pretium prettyping preventdefault preventextensions +previousslide PREVIOUSTRACK PREVUNIQUE prflx +pricelist primarykey primcount primis @@ -3951,6 +3841,7 @@ proident Proin proinde promobutton +properities propertyaccessors propertyisenumerable propfind @@ -3965,6 +3856,7 @@ proxify proxyfied proxyhandler Proxying +présenté pseudoclass pseudoclasses Pseudocode @@ -3988,16 +3880,19 @@ purejsgame purgecaches pushsubscriptionchange PVRTC +PWA's pwabuilder pwamp pwas -PWA's pwid pwllgwyngyllgogerychwyrngogogoch PXHQTXP pylint Pythagora +pythonanywhere +pythonaware pyxpidl +páginas Qbsshxk QCIF QCMS @@ -4058,6 +3953,7 @@ ratechange ratione Rauschmayer Rauschmayer's +rawupdate Raytracer RBGA rcap @@ -4071,10 +3967,12 @@ Readablestream readback readdir readingerror +readonlyinline readwrite readwriteflush READYSTATE realid +realpython Realtek Rearrangeable reate @@ -4085,6 +3983,7 @@ receivebox Recep Rects recvonly +redblue reddinate Redeclaration Redeclarations @@ -4097,14 +3996,14 @@ redsquare redtext redtoggle redtogreen +redyellow +redzero reen Reeza -Référence referenceable referer referralpolicy reflectionchange -Régagnon regexes regionless reimplementation @@ -4145,19 +4044,22 @@ reprioritize reproject repudiandae requirable +requireinteraction requireuserinteraction Reregister rerum rescan rescoping +reselecting resends -réservé resh Resig Resig's resizability +Resizeable resizer resizerpanel +resnapped resolvedoptions resourcetimingbufferfull respecified @@ -4168,7 +4070,6 @@ restcookbook restofurl restparameters resultobj -résumé retarget retargeted retargeting @@ -4214,6 +4115,7 @@ roletype rolloff Romaji romanlow +Ronaldo Roselli Rossen Rossum @@ -4245,6 +4147,7 @@ RTCICE RTCIP RTCP RTCRTP +rtctransform RTCWEB RTMP RTMPE @@ -4264,8 +4167,14 @@ Runtimes rustc Rustup rutrum +rvfc RWIN Ryuno +Référence +Régagnon +réservé +résumé +s'écrase sadipscing Saepe safariextz @@ -4282,6 +4191,7 @@ Saltasaurus Salva SAMEORIGIN Samesite +samplepay Samplerate samplesize samr @@ -4308,6 +4218,7 @@ scalethumbend scalethumbstart scalethumbtick scalex +scanability scancode scanf scangamepads @@ -4320,10 +4231,10 @@ Schiff Schola Scholz schon -schön Schonheit schreibt Schwarz +schön scooby scopable scottohara @@ -4333,8 +4244,11 @@ screenful screenleft screenorientation screenreader +screenreaders +screenschange screentop Scribie +Scrimba Scriptable Scripters scriptname @@ -4366,12 +4280,12 @@ SECAM Sechelt secmetadata secp -s'écrase sectionhead Securecontext securityheaders securitypolicy securitypolicyviolation +seecompattable Seekable seekbackward seeked @@ -4383,7 +4297,9 @@ Segoe segundos Seizureless selectables +selectchange selectedcandidatepairchange +selectedness selectend selectionchange selectrepo @@ -4402,14 +4318,15 @@ senectus sentenceboundary Separatei sequi -será serialno serialnumber +Serpentina serverhello Serverside serverstart SERVFAIL serviceworker +será SESAC sess sessionhistory @@ -4447,10 +4364,14 @@ SFNT Shadeed shadowdom shadowrootclonable -shān +shadowrootdelegatesfocus +shadowrootmode +shadowrootserializable Sharada sharedarraybuffer +sharedmem sharedworker +sharpyuv Shazaam Sheppy shexp @@ -4462,12 +4383,16 @@ shippingoptionchange Shireen Shoeshop shortlink +shortlinks showable showbf shrd +shrinkwap +shrinkwrapping shtm SHTTP Shumway +shān sidebox sideload sideloaded @@ -4485,8 +4410,8 @@ SIGTERM Silf Silverlight SIMD -𝚜𝚒𝚗𝚑 Sinhala +sinkchange Sino sint Sintel @@ -4513,7 +4438,6 @@ skjfndskjfnbdskjfb skybox skyboxes Skywalker -𝔰𝔩 slabcraft Slaght slideheading @@ -4530,6 +4454,7 @@ smakar smallcaps SMARTPOSTER smartquotes +smashingmagazine smbps smcp SMIL @@ -4542,6 +4467,7 @@ Smus Snackbars snapport snapshotted +Snapshotting snapsvg SNES snews @@ -4585,6 +4511,7 @@ someroute Somers somescript somesite +somestate somesystem someusername somevideo @@ -4645,8 +4572,6 @@ spritesheets sprop sqlzoo Sqrd -𝚜𝚚𝚛𝚝 -𝚂𝚀𝚁𝚃 squarefree squeezeend squeezestart @@ -4659,6 +4584,7 @@ sref srflx SRGB srgba +srihash SRTP sscanf ssedemo @@ -4666,6 +4592,7 @@ SSIDs SSML SSRC ssthresh +stackexchange Stackoverflow Stalybridge Starcraft @@ -4689,6 +4616,8 @@ steponup STITCHTYPE STIX Storei +Stormys +Stratford strawman strcat strcmp @@ -4720,6 +4649,7 @@ studiorum stunprotocol stunserver Stylable +styleable styleeditor styleguide stylemap @@ -4742,12 +4672,15 @@ subexpression subexpressions subfeature subfolders +subformula +subformulas subframe subframes Subgrid -subgridded subgrid's +subgridded subgrids +subheaders Subinstruction subkey sublicensable @@ -4765,7 +4698,10 @@ subpage Subpages subpanels subpaths +subpattern subpatterns +subpopover +subproject subprojects subproperty subrectangle @@ -4776,6 +4712,8 @@ Subresource subresources subsampled Subsampling +Subsentence +subsetting substate substeps substr @@ -4783,6 +4721,8 @@ substream substreams Subtag Subtags +subteam +subteams subtr Subtractor subvalue @@ -4799,6 +4739,7 @@ sund sundried Sundström sunhpark +sunsetting sunt suntheme Superc @@ -4807,6 +4748,7 @@ superdomain superfast Supermedium superscaling +supersets superspeed supportedlocalesof supportedvaluesof @@ -4841,6 +4783,7 @@ svgz svmax svmin Svpf +swashoff swashon swimjiy Swisswatch @@ -4868,13 +4811,14 @@ takimata takr Takri talu +Tamaran tamen taml tamldec -𝚝𝚊𝚗𝚑 Tanx targetable TARGETDURATION +targettable taskattribution taskbars taskboard @@ -4916,10 +4860,12 @@ textarget textboxes textcolor textencoder +textformatupdate textnode TEXTPATH texttop texttrack +textupdate TEXTUREI tgfe Thaana @@ -4960,6 +4906,7 @@ timecodes Timecount timedelta timefield +timeframe Timepicker timerange timeslice @@ -5115,16 +5062,18 @@ truedoc truetype Trunc Trustwave +truthyness trycatch tsize TSLÍ -ˈtʃɑːli TTFB TTML TTSI +tunetheweb turnpassword turnserver turpis +tutsplus tvkeys tvremote tweened @@ -5189,6 +5138,8 @@ undecoded undeletable underflowing underflows +underliner +underlyingly underover Underscript Underscripts @@ -5303,7 +5254,9 @@ urlscheme urna urpmi Uruk +usecase usedtx +useinbandfec usepackage useragentstring userbase @@ -5336,6 +5289,7 @@ vaii validlink Vallejoanderson vals +valuechange valueof Vanderheiden Vandermonde @@ -5385,6 +5339,7 @@ videooutput videoplayer vidi Vieno +viewbox Viewmodel Viewports viewsource @@ -5394,6 +5349,7 @@ VIRTUALENV virtualenvs VIRTUALENVWRAPPER virtualizes +virtualkeyboardpolicy Virtuals visibilitychange visibilitystate @@ -5490,14 +5446,19 @@ weakmap weakset Weathersby weba +webappmanifest Webapps webassembly webaudio webauthn +webbundle webcal +webcodecs Webcompat webcomponents webconsole +webdav +webdesignerdepot Webdev webdeveloper webext @@ -5514,6 +5475,7 @@ webglreport webglsamples webgpu webhint +webidentity Webidl webkitdirectory webkitmouseforcechanged @@ -5542,6 +5504,7 @@ webshell Websniffer Websockets webspeech +webtransport Webvr WEBVTT webxr @@ -5561,6 +5524,7 @@ WHATWG's Whereami wherearemyglasses Whitenoise +whitepoint whitespaces Whitlock Whittaker @@ -5583,6 +5547,7 @@ wireframed wirelessly Wireshark Wirfs +wisedog Wisen wisi Wolenetz @@ -5591,6 +5556,7 @@ Wordmark wordmarks wordprocessingml workfile +workgroups Worklet worklet's Worklets @@ -5605,6 +5571,7 @@ writability writeln WRITEMASK writemasks +writingsuggestions wrnogly Wrox WSCTRL @@ -5715,6 +5682,9 @@ Zehe Zenevich ZENKAKU Zepto +zeroblue +zeroyellow +zerozero zfail Zheng zhuyin @@ -5737,6 +5707,13 @@ Zstandard zvon ZWNBSP ZWSP +Áaron +Émanuel +Österreich +ˈbraːˈvo +ˈdeltɑ +ˈtʃɑːli +ˈælfa ζήτα θdeg Θεϊκό @@ -5780,13 +5757,13 @@ ZWSP לדוגמא עִבְרִית أحلامك -اَلأَعْشَى الانتقال التطبيق العربية الفقرة اليسار اليمين +اَلأَعْشَى باللغة تحقيق تطبيق @@ -5796,4 +5773,27 @@ ZWSP شسيبتنمك طولا مرحبا +𝐜𝐨𝐬 +𝔰𝔩 +𝙻𝙽 +𝙻𝙾𝙶 +𝙼𝚊𝚝𝚑 +𝙿𝙸 +𝚂𝚀𝚁𝚃 +𝚊𝚌𝚘𝚜 +𝚊𝚌𝚘𝚜𝚑 +𝚊𝚜𝚒𝚗 +𝚊𝚜𝚒𝚗𝚑 +𝚊𝚝𝚊𝚗 +𝚊𝚝𝚊𝚗𝚑 +𝚌𝚋𝚛𝚝 +𝚌𝚘𝚜𝚑 +𝚎𝚡𝚙 +𝚎𝚡𝚙𝚖 +𝚑𝚢𝚙𝚘𝚝 +𝚕𝚘𝚐 +𝚙𝚘𝚠 +𝚜𝚒𝚗𝚑 +𝚜𝚚𝚛𝚝 +𝚝𝚊𝚗𝚑 𞤲𞥋𞤣𞤫 diff --git a/.vscode/terms-abbreviations.txt b/.vscode/terms-abbreviations.txt index e297fc75815e594..917bcc4a462c317 100644 --- a/.vscode/terms-abbreviations.txt +++ b/.vscode/terms-abbreviations.txt @@ -2,10 +2,10 @@ affordance affordances APNG Axess -bézier Bhattacharya Brosset Brotli +bézier callouts Caniuse cdylib diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt index 0d1ea64036279dc..44044a42ed32130 100644 --- a/files/en-us/_redirects.txt +++ b/files/en-us/_redirects.txt @@ -8784,7 +8784,7 @@ /en-US/docs/Web/API/IdleDetector/onchange /en-US/docs/Web/API/IdleDetector/change_event /en-US/docs/Web/API/IdleDetector/requestPermission /en-US/docs/Web/API/IdleDetector/requestPermission_static /en-US/docs/Web/API/Image /en-US/docs/Web/API/HTMLImageElement/Image -/en-US/docs/Web/API/ImageBitmapFactories/createImageBitmap /en-US/docs/Web/API/createImageBitmap +/en-US/docs/Web/API/ImageBitmapFactories/createImageBitmap /en-US/docs/Web/API/Window/createImageBitmap /en-US/docs/Web/API/ImageBitmapRenderingContext/transferImageBitmap /en-US/docs/Web/API/ImageBitmapRenderingContext/transferFromImageBitmap /en-US/docs/Web/API/ImageData.ImageData /en-US/docs/Web/API/ImageData/ImageData /en-US/docs/Web/API/ImageData.data /en-US/docs/Web/API/ImageData/data @@ -10254,7 +10254,7 @@ /en-US/docs/Web/API/WindowOrWorkerGlobalScope/caches /en-US/docs/Web/API/Window/caches /en-US/docs/Web/API/WindowOrWorkerGlobalScope/clearInterval /en-US/docs/Web/API/Window/clearInterval /en-US/docs/Web/API/WindowOrWorkerGlobalScope/clearTimeout /en-US/docs/Web/API/clearTimeout -/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap /en-US/docs/Web/API/createImageBitmap +/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap /en-US/docs/Web/API/Window/createImageBitmap /en-US/docs/Web/API/WindowOrWorkerGlobalScope/crossOriginIsolated /en-US/docs/Web/API/Window/crossOriginIsolated /en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch /en-US/docs/Web/API/Window/fetch /en-US/docs/Web/API/WindowOrWorkerGlobalScope/indexedDB /en-US/docs/Web/API/Window/indexedDB @@ -10436,6 +10436,7 @@ /en-US/docs/Web/API/console/timeStamp /en-US/docs/Web/API/console/timeStamp_static /en-US/docs/Web/API/console/trace /en-US/docs/Web/API/console/trace_static /en-US/docs/Web/API/console/warn /en-US/docs/Web/API/console/warn_static +/en-US/docs/Web/API/createImageBitmap /en-US/docs/Web/API/Window/createImageBitmap /en-US/docs/Web/API/crossOriginIsolated /en-US/docs/Web/API/Window/crossOriginIsolated /en-US/docs/Web/API/crypto_property /en-US/docs/Web/API/Window/crypto /en-US/docs/Web/API/document.URL /en-US/docs/Web/API/Document/URL diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json index ef815386a138e60..55ab60dcce654a8 100644 --- a/files/en-us/_wikihistory.json +++ b/files/en-us/_wikihistory.json @@ -66628,6 +66628,28 @@ "modified": "2020-10-15T22:16:13.286Z", "contributors": ["mfuji09", "wbamberg"] }, + "Web/API/Window/createImageBitmap": { + "modified": "2020-10-15T21:37:56.407Z", + "contributors": [ + "gmanpersona", + "mfluehr", + "styfle", + "fscholz", + "DomenicDenicola", + "Halfman", + "jaffathecake", + "jpmedley", + "Brettz9", + "MatthiasSaihttam", + "nmve", + "chrisdavidmills", + "yisibl", + "DrRataplan", + "zeird", + "Kaku", + "adria" + ] + }, "Web/API/Window/crossOriginIsolated": { "modified": "2020-10-15T22:25:16.295Z", "contributors": ["ExE-Boss", "chrisdavidmills"] @@ -71571,28 +71593,6 @@ "myakura" ] }, - "Web/API/createImageBitmap": { - "modified": "2020-10-15T21:37:56.407Z", - "contributors": [ - "gmanpersona", - "mfluehr", - "styfle", - "fscholz", - "DomenicDenicola", - "Halfman", - "jaffathecake", - "jpmedley", - "Brettz9", - "MatthiasSaihttam", - "nmve", - "chrisdavidmills", - "yisibl", - "DrRataplan", - "zeird", - "Kaku", - "adria" - ] - }, "Web/API/setTimeout": { "modified": "2020-10-15T21:06:28.845Z", "contributors": [ diff --git a/files/en-us/learn/css/building_blocks/organizing/index.md b/files/en-us/learn/css/building_blocks/organizing/index.md index b6de822a7edd92c..0a33fddc876f462 100644 --- a/files/en-us/learn/css/building_blocks/organizing/index.md +++ b/files/en-us/learn/css/building_blocks/organizing/index.md @@ -332,7 +332,7 @@ Read more about this system [BEM 101](https://css-tricks.com/bem-101/) on CSS Tr #### Other common systems -There are a large number of these systems in use. Other popular approaches include [Scalable and Modular Architecture for CSS (SMACSS)](https://smacss.com/), created by Jonathan Snook, [ITCSS](https://itcss.io/) from Harry Roberts, and [Atomic CSS (ACSS)](https://acss.io/), originally created by Yahoo!. If you come across a project that uses one of these approaches, then the advantage is that you will be able to search and find many articles and guides to help you understand how to code in the same style. +There are a large number of these systems in use. Other popular approaches include [Scalable and Modular Architecture for CSS (SMACSS)](https://smacss.com/), created by Jonathan Snook, [ITCSS](https://itcss.io/) from Harry Roberts, and [Atomizer CSS (ACSS)](https://acss-io.github.io/atomizer/), originally created by Yahoo!. If you come across a project that uses one of these approaches, then the advantage is that you will be able to search and find many articles and guides to help you understand how to code in the same style. The disadvantage of using such a system is that they can seem overly complex, especially for smaller projects. diff --git a/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md b/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md index 9763fb5e047c8bf..cae4a47972d6ec8 100644 --- a/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md +++ b/files/en-us/learn/css/css_layout/practical_positioning_examples/index.md @@ -258,7 +258,7 @@ In our second example, we will take our first example — our info-box — and a > [!NOTE] > You can see the finished example running live at [fixed-info-box.html](https://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/fixed-info-box.html) ([source code](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/fixed-info-box.html)). Check it out to get an idea of what you will be building in this section of the article. -As a starting point, you can use your completed example from the first section of the article, or make a local copy of [info-box.html](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/info-box.html) from our GitHub repo. +As a starting point, you can use your completed example from the first section of the article, or make a local copy of [tabbed-info-box.html](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/tabbed-info-box.html) from our GitHub repo. ### HTML additions diff --git a/files/en-us/learn/css/styling_text/web_fonts/index.md b/files/en-us/learn/css/styling_text/web_fonts/index.md index 67746b51cf8c4e0..3da26ecf79b015b 100644 --- a/files/en-us/learn/css/styling_text/web_fonts/index.md +++ b/files/en-us/learn/css/styling_text/web_fonts/index.md @@ -119,7 +119,7 @@ Web services for font generation typically limit file sizes. In such a case, con 1. [sfnt2woff-zopfli](https://github.com/bramstein/sfnt2woff-zopfli) for converting ttf to woff 2. [fontforge](https://fontforge.org/) for converting from ttf to svg -3. [batik ttf2svg](https://people.apache.org/~clay/batik/ttf2svg.html) for converting from ttf to svg +3. [batik ttf2svg](https://xmlgraphics.apache.org/batik/tools/font-converter.html) for converting from ttf to svg 4. [woff2](https://github.com/google/woff2) for converting from ttf to woff2 ### Implementing the code in your demo diff --git a/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md b/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md index e69248133149055..5bf53da692ce1f1 100644 --- a/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md +++ b/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md @@ -21,7 +21,7 @@ To begin, you'll need to answer these questions: 3. **What does your website look like,** in simple high-level terms? What's the background color? What kind of font is appropriate: formal, cartoony, bold and loud, subtle? > [!NOTE] -> Complex projects need detailed guidelines that go into all the details of colors, fonts, spacing between items on a page, appropriate writing style, and so on. This is sometimes called a design guide, design system, or brand book, and you can see an example at the [Firefox Acorn Design System](https://acorn.firefox.com/latest/). +> Complex projects need detailed guidelines that go into all the details of colors, fonts, spacing between items on a page, appropriate writing style, and so on. This is sometimes called a design guide, design system, or brand book, and you can see an example at the [Firefox Acorn Design System](https://acorn.firefox.com/latest). ## Sketching out your design diff --git a/files/en-us/mdn/community/issues/index.md b/files/en-us/mdn/community/issues/index.md index ffb7de143ad1e3f..5316815665c88df 100644 --- a/files/en-us/mdn/community/issues/index.md +++ b/files/en-us/mdn/community/issues/index.md @@ -103,7 +103,7 @@ These are the general steps for working on an issue: > [!NOTE] > An issue with the `needs triage` label indicates that the MDN Web Docs core team has not reviewed the issue yet, and you shouldn't begin work on it. -2. **Assign the issue to yourself:** After finding an issue you'd like to work on, make sure that the issue is not assigned to anybody else. Add a comment saying you would like to work on the issue, and if you are able to, [assign the issue to yourself](https://docs.github.com/en/issues/tracking-your-work-with-issues/assigning-issues-and-pull-requests-to-other-github-users#assigning-an-individual-issue-or-pull-request). +2. **Assign the issue to yourself:** After finding an issue you'd like to work on, make sure that the issue is not assigned to anybody else. Add a comment saying you would like to work on the issue, and if you are able to, [assign the issue to yourself](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users#assigning-an-individual-issue-or-pull-request). 3. **Do the research:** Most issues need some investigation before work can start. @@ -111,7 +111,7 @@ These are the general steps for working on an issue: - If the issue is well-described, and the work is pretty obvious, go ahead and do it. - If the issue is not well-described, and/or you are not sure what is needed, feel free to @mention the poster and ask for more information. -4. **Make the changes:** Fork and branch the repository. Do your work and open a [pull request](/en-US/docs/MDN/Community/Pull_requests) in the repository. [Reference the issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) in the pull request description. Depending on the files you've updated in the pull request, a reviewer will be assigned to your pull request automatically. (Teams per topic area are defined in the [CODEOWNERS](https://github.com/mdn/content/blob/main/.github/CODEOWNERS) file). +4. **Make the changes:** Fork and branch the repository. Do your work and open a [pull request](/en-US/docs/MDN/Community/Pull_requests) in the repository. [Reference the issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue) in the pull request description. Depending on the files you've updated in the pull request, a reviewer will be assigned to your pull request automatically. (Teams per topic area are defined in the [CODEOWNERS](https://github.com/mdn/content/blob/main/.github/CODEOWNERS) file). After opening the pull request, if you find you no longer have the time to make changes or incorporate review feedback, let the team know as soon as possible in a comment in the pull request. This will help the team assign another interested contributor to complete the work on the pull request and close the linked issue. diff --git a/files/en-us/mdn/community/pull_requests/index.md b/files/en-us/mdn/community/pull_requests/index.md index 05761cfa36c65ac..bc75f4ffe3626e7 100644 --- a/files/en-us/mdn/community/pull_requests/index.md +++ b/files/en-us/mdn/community/pull_requests/index.md @@ -62,7 +62,7 @@ When you're ready to open a pull request, follow these guidelines: If a pull request becomes too large, the reviewer may close it and ask that you to submit pull requests for each logical set of changes that belong together. - **Add a description of the changes:** Provide as much context and rationale for the pull request as possible. - **Add the link to the issue you are closing:** In the pull request description, add 'Fixes' if it fully resolves the issue or 'Relates to' if it is a related issue. - More information about linking to issues in pull requests can be found in [GitHub docs](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). + More information about linking to issues in pull requests can be found in [GitHub docs](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). - **Add 'depends on'** with a link to a dependency if there are pull requests that must be merged first (e.g., code examples in other repositories). - **Accompany code example changes with content changes:** This is important to ensure that updated examples are served correctly. If you're making content changes that affect how examples are used, the related code examples should also be updated. diff --git a/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md b/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md index ef40b20e525dc55..39749671dba3630 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/webnavigation/index.md @@ -25,8 +25,8 @@ Each event corresponds to a particular stage in the navigation. The sequence of - Additionally: - `{{WebExtAPIRef("webNavigation.onCreatedNavigationTarget", "onCreatedNavigationTarget")}}` is fired before `onBeforeNavigate` if the browser needed to create a new tab or window for the navigation (for example, because the user opened a link in a new tab). - - {{WebExtAPIRef("webNavigation.onHistoryStateUpdated", "onHistoryStateUpdated")}} is fired if a page uses the [history API (2011)](http://diveintohtml5.info/history.html) to update the URL displayed in the browser's location bar. - - {{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated", "onReferenceFragmentUpdated")}} is fired if the [fragment identifier](https://en.wikipedia.org/wiki/Fragment_identifier) for a page is changed. + - {{WebExtAPIRef("webNavigation.onHistoryStateUpdated", "onHistoryStateUpdated")}} is fired if a page uses the [history API](/en-US/docs/Web/API/History_API) to update the URL displayed in the browser's location bar. + - {{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated", "onReferenceFragmentUpdated")}} is fired if the [fragment identifier](/en-US/docs/Web/URI/Fragment) for a page is changed. - {{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} can be fired at any point. Each navigation is a URL transition in a particular browser frame. The browser frame is identified by a tab ID and a frame ID. The frame may be the top-level browsing context in the tab, or may be a nested browsing context implemented as an [iframe](/en-US/docs/Web/HTML/Element/iframe). @@ -70,7 +70,7 @@ To use this API you need to have the "webNavigation" [permission](/en-US/docs/Mo - {{WebExtAPIRef("webNavigation.onTabReplaced")}} - : Fired when the contents of the tab is replaced by a different (usually previously pre-rendered) tab. - {{WebExtAPIRef("webNavigation.onHistoryStateUpdated")}} - - : Fired when the page used the [history API (2011)](http://diveintohtml5.info/history.html) to update the URL displayed in the browser's location bar. + - : Fired when the page used the [history API (2011)](/en-US/docs/Web/API/History_API) to update the URL displayed in the browser's location bar. ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md b/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md index 42247387afacd40..31c1a2708d6b5ed 100644 --- a/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/user_interface/omnibox/index.md @@ -29,7 +29,7 @@ browser.omnibox.setDefaultSuggestion({ }); ``` -You can then add the code to provide the customized content by listening for {{WebExtAPIRef("omnibox.onInputStarted")}}, which is dispatched when the user has typed the keyword and a space, and {{WebExtAPIRef("omnibox.onInputChanged")}}, which is dispatched whenever the user updates the address bar entry. You can then populate the suggestions, in this case building a [search of mozilla-central](https://searchfox.org/mozilla-central) using the term entered by the user: +You can then add the code to provide the customized content by listening for {{WebExtAPIRef("omnibox.onInputStarted")}}, which is dispatched when the user has typed the keyword and a space, and {{WebExtAPIRef("omnibox.onInputChanged")}}, which is dispatched whenever the user updates the address bar entry. You can then populate the suggestions, in this case building a [search of mozilla-central](https://searchfox.org/mozilla-central/search) using the term entered by the user: ```js browser.omnibox.onInputChanged.addListener((text, addSuggestions) => { diff --git a/files/en-us/mozilla/firefox/releases/111/index.md b/files/en-us/mozilla/firefox/releases/111/index.md index cd0524c7cfdb7fd..6d6c889946af47e 100644 --- a/files/en-us/mozilla/firefox/releases/111/index.md +++ b/files/en-us/mozilla/firefox/releases/111/index.md @@ -43,7 +43,7 @@ No notable changes. See [Firefox bug 1785123](https://bugzil.la/1785123) for more details. - The HTTP [`Authorization`](/en-US/docs/Web/HTTP/Headers/Authorization) header is removed from [`fetch()`](/en-US/docs/Web/API/Window/fetch) and [`XMLHttpRequest`](/en-US/docs/Web/API/XMLHttpRequest) requests that are redirected cross-origin (`fetch()` headers may be added by developers using the [`option.headers`](/en-US/docs/Web/API/Window/fetch#headers) argument). See [Firefox bug 1802086](https://bugzil.la/1802086) for more details. -- The `none` value of the `options.imageOrientation` parameter passed to [`createImageBitmap()`](/en-US/docs/Web/API/createImageBitmap) has been renamed to [`from-image`](/en-US/docs/Web/API/createImageBitmap#from-image). +- The `none` value of the `options.imageOrientation` parameter passed to {{domxref("Window.createImageBitmap()")}} and {{domxref("WorkerGlobalScope.createImageBitmap()")}} has been renamed to `from-image`. This is to better match the meaning of the equivalent CSS [`image-orientation`](/en-US/docs/Web/CSS/image-orientation) property. ([Firefox bug 1809740](https://bugzil.la/1809740)). #### DOM diff --git a/files/en-us/mozilla/firefox/releases/42/index.md b/files/en-us/mozilla/firefox/releases/42/index.md index 90437e362e37fc3..459f5db89fc8346 100644 --- a/files/en-us/mozilla/firefox/releases/42/index.md +++ b/files/en-us/mozilla/firefox/releases/42/index.md @@ -91,7 +91,7 @@ Our experimental implementation of the [Shadow DOM](/en-US/docs/Web/API/Web_comp #### New APIs -- The {{domxref("ImageBitmap")}} interface and the {{domxref("createImageBitmap()")}} method have been implemented. They are available on regular window scripts and in Web workers and allow efficient posting of images between window and worker contexts ([Firefox bug 1044102](https://bugzil.la/1044102)). +- The {{domxref("ImageBitmap")}} interface, the {{domxref("Window.createImageBitmap()")}} and {{domxref("WorkerGlobalScope.createImageBitmap()")}} method have been implemented. They are available on regular window scripts and in Web workers and allow efficient posting of images between window and worker contexts ([Firefox bug 1044102](https://bugzil.la/1044102)). #### Miscellaneous diff --git a/files/en-us/mozilla/firefox/releases/65/index.md b/files/en-us/mozilla/firefox/releases/65/index.md index 2a5aff63e9b50b5..47063d4a3ef0e4b 100644 --- a/files/en-us/mozilla/firefox/releases/65/index.md +++ b/files/en-us/mozilla/firefox/releases/65/index.md @@ -93,7 +93,7 @@ _No changes._ - {{domxref("Performance.toJSON()")}} has been exposed to {{domxref("Web_Workers_API", "Web Workers", "", "1")}} ([Firefox bug 1504958](https://bugzil.la/1504958)). - {{domxref("XMLHttpRequest")}} requests will now throw a `NetworkError` if the requested content type is a `Blob`, and the request method is not `GET` ([Firefox bug 1502599](https://bugzil.la/1502599)). - The `-moz-` prefixed versions of many of the {{domxref("Fullscreen API", "", "", "1")}} features have been deprecated, and will now display deprecation warnings in the JavaScript console when encountered ([Firefox bug 1504946](https://bugzil.la/1504946)). -- {{domxref("createImageBitmap()")}} now supports SVG images ({{domxref("SVGImageElement")}}) as an image source ([Firefox bug 1500768](https://bugzil.la/1500768)). +- {{domxref("Window.createImageBitmap()")}} and {{domxref("WorkerGlobalScope.createImageBitmap()")}} now supports SVG images ({{domxref("SVGImageElement")}}) as an image source ([Firefox bug 1500768](https://bugzil.la/1500768)). #### DOM events diff --git a/files/en-us/mozilla/firefox/releases/93/index.md b/files/en-us/mozilla/firefox/releases/93/index.md index 1627d890b8547ae..ea0031e358ae38b 100644 --- a/files/en-us/mozilla/firefox/releases/93/index.md +++ b/files/en-us/mozilla/firefox/releases/93/index.md @@ -25,7 +25,7 @@ This article provides information about the changes in Firefox 93 that will affe ### JavaScript - [Class `static` initialization blocks](/en-US/docs/Web/JavaScript/Reference/Classes/Static_initialization_blocks) are now supported, allowing more flexible initialization of {{jsxref("Classes/static", "static")}} properties ([Firefox bug 1725689](https://bugzil.la/1725689)). -- The properties `imageOrientation` and `premultiplyAlpha` can be passed to the method {{domxref("createImageBitmap()")}} using the `options` object ([Firefox bug 1367251](https://bugzil.la/1367251)). +- The properties `imageOrientation` and `premultiplyAlpha` can be passed to the method {{domxref("Window.createImageBitmap()")}} and {{domxref("WorkerGlobalScope.createImageBitmap()")}} using the `options` object ([Firefox bug 1367251](https://bugzil.la/1367251)). - {{jsxref("Intl.supportedValuesOf()")}} is now supported, allowing code to enumerate values supported by an implementation, This might be used, for example, to download a polyfill for just the missing category of values ([Firefox bug 1670033](https://bugzil.la/1670033)). ### HTTP diff --git a/files/en-us/mozilla/firefox/releases/98/index.md b/files/en-us/mozilla/firefox/releases/98/index.md index 66684cff8d807a9..3f98fff0678b7f9 100644 --- a/files/en-us/mozilla/firefox/releases/98/index.md +++ b/files/en-us/mozilla/firefox/releases/98/index.md @@ -29,7 +29,7 @@ No notable changes #### DOM - {{domxref("HTMLElement.outerText")}} is now supported ([Firefox bug 1709790](https://bugzil.la/1709790)). -- The properties `colorSpaceConversion`, `resizeWidth` and `resizeHeight` can be passed to the method {{domxref("createImageBitmap()")}} using the `options` object ([Firefox bug 1748868](https://bugzil.la/1748868) and [Firefox bug 1733559](https://bugzil.la/1733559)). +- The properties `colorSpaceConversion`, `resizeWidth` and `resizeHeight` can be passed to the method {{domxref("Window.createImageBitmap()")}} and {{domxref("WorkerGlobalScope.createImageBitmap()")}} using the `options` object ([Firefox bug 1748868](https://bugzil.la/1748868) and [Firefox bug 1733559](https://bugzil.la/1733559)). #### Removals diff --git a/files/en-us/web/api/file/index.md b/files/en-us/web/api/file/index.md index 3b99558bcdc0518..94bf2a11e850aaf 100644 --- a/files/en-us/web/api/file/index.md +++ b/files/en-us/web/api/file/index.md @@ -11,7 +11,13 @@ The **`File`** interface provides information about files and allows JavaScript `File` objects are generally retrieved from a {{DOMxRef("FileList")}} object returned as a result of a user selecting files using the {{HTMLElement("input")}} element, or from a drag and drop operation's {{DOMxRef("DataTransfer")}} object. -A `File` object is a specific kind of {{DOMxRef("Blob")}}, and can be used in any context that a Blob can. In particular, {{DOMxRef("FileReader")}}, {{DOMxRef("URL.createObjectURL_static", "URL.createObjectURL()")}}, {{DOMxRef("createImageBitmap()")}}, the [`body`](/en-US/docs/Web/API/RequestInit#body) option to {{domxref("Window/fetch", "fetch()")}}, and {{DOMxRef("XMLHttpRequest.send()")}} accept both `Blob`s and `File`s. +A `File` object is a specific kind of {{DOMxRef("Blob")}}, and can be used in any context that a Blob can. In particular, the following APIs accept both `Blob`s and `File` objects: + +- {{DOMxRef("FileReader")}} +- {{DOMxRef("URL.createObjectURL_static", "URL.createObjectURL()")}} +- {{DOMxRef("Window.createImageBitmap()")}} and {{DOMxRef("WorkerGlobalScope.createImageBitmap()")}} +- the [`body`](/en-US/docs/Web/API/RequestInit#body) option to {{domxref("Window/fetch", "fetch()")}} +- {{DOMxRef("XMLHttpRequest.send()")}} . See [Using files from web applications](/en-US/docs/Web/API/File_API/Using_files_from_web_applications) for more information and examples. diff --git a/files/en-us/web/api/gpudevice/createtexture/index.md b/files/en-us/web/api/gpudevice/createtexture/index.md index d6e351f07b97cee..4cba5459ee99ef3 100644 --- a/files/en-us/web/api/gpudevice/createtexture/index.md +++ b/files/en-us/web/api/gpudevice/createtexture/index.md @@ -120,7 +120,7 @@ The following criteria must be met when calling **`createTexture()`**, otherwise In the WebGPU samples [Textured Cube sample](https://webgpu.github.io/webgpu-samples/samples/texturedCube/), a texture to use on the faces of a cube is created by: -- Loading the image into an {{domxref("HTMLImageElement")}} and creating an image bitmap using {{domxref("createImageBitmap()")}}. +- Loading the image into an {{domxref("HTMLImageElement")}} and creating an image bitmap using {{domxref("Window.createImageBitmap", "createImageBitmap()")}}. - Creating a new texture using `createTexture()`. - Copying the image bitmap into the texture using {{domxref("GPUQueue.copyExternalImageToTexture()")}}. diff --git a/files/en-us/web/api/gputexture/index.md b/files/en-us/web/api/gputexture/index.md index 03043db38f6f6ff..4e29dcb7d94663f 100644 --- a/files/en-us/web/api/gputexture/index.md +++ b/files/en-us/web/api/gputexture/index.md @@ -47,7 +47,7 @@ A `GPUTexture` object instance is created using the {{domxref("GPUDevice.createT In the WebGPU samples [Textured Cube sample](https://webgpu.github.io/webgpu-samples/samples/texturedCube/), a texture to use on the faces of a cube is created by: -- Loading the image into an {{domxref("HTMLImageElement")}} and creating an image bitmap using {{domxref("createImageBitmap()")}}. +- Loading the image into an {{domxref("HTMLImageElement")}} and creating an image bitmap using {{domxref("Window.createImageBitmap", "createImageBitmap()")}}. - Creating a new `GPUTexture` using `createTexture()`. - Copying the image bitmap into the texture using {{domxref("GPUQueue.copyExternalImageToTexture()")}}. diff --git a/files/en-us/web/api/htmloptionscollection/add/index.md b/files/en-us/web/api/htmloptionscollection/add/index.md new file mode 100644 index 000000000000000..f0e3d23d613c721 --- /dev/null +++ b/files/en-us/web/api/htmloptionscollection/add/index.md @@ -0,0 +1,67 @@ +--- +title: "HTMLOptionsCollection: add() method" +short-title: add() +slug: Web/API/HTMLOptionsCollection/add +page-type: web-api-instance-method +browser-compat: api.HTMLOptionsCollection.add +--- + +{{APIRef("HTML DOM")}} + +The **`add()`** method of the {{DOMxRef("HTMLOptionsCollection")}} interface adds an {{domxref("HTMLOptionElement")}} or {{domxref("HTMLOptGroupElement")}} to this `HTMLOptionsCollection`. + +## Syntax + +```js-nolint +add(item) +add(item, before) +``` + +### Parameters + +- `item` + - : An {{domxref("HTMLOptionElement")}} or {{domxref("HTMLOptGroupElement")}}. +- `before` {{optional_inline}} + - : An element of the collection, or a numeric 0-based index representing the element that the `item` should be inserted before. If omitted, `null`, or the index does not exist, the new element is appended to the end of the collection. + +### Return value + +None ({{jsxref("undefined")}}). + +### Exceptions + +- `HierarchyRequestError` {{DOMxRef("DOMException")}} + - : Thrown if the `item` passed to the method is an ancestor of the element into which it is to be inserted. + +## Description + +By default, the `add()` appends the {{HTMLelement("option")}} or {{HTMLelement("optgroup")}} passed as the parameter to the end of the collection. You can define where the added `` should be placed by specifying the `before` parameter. The `before` is the `` will be appended as the last element in the collection, outside of any {{HTMLelement("optgroup")}}. If the `` element can only contain `` elements only. In other words, attempting to add an `HTMLOptGroupElement` before an `` may silently fail if the ``. + +## Examples + +```js +const optionList = document.querySelector("select").options; +const firstOption = document.createElement("option"); +firstOption.text = "new item"; +optionList.add(firstOption, 0); // added as the first item +optionList.add(optionList[0]); // moves the first item to the end +``` + +## Specifications + +{{Specifications}} + +## Browser compatibility + +{{Compat}} + +## See also + +- {{HTMLElement("select")}} +- {{DOMxRef("HTMLOptionsCollection.remove")}} +- {{DOMxRef("HTMLOptionsCollection.length")}} +- {{DOMxRef("HTMLOptionsCollection.selectedIndex")}} diff --git a/files/en-us/web/api/htmloptionscollection/index.md b/files/en-us/web/api/htmloptionscollection/index.md index b2900da464ba54c..7f8b356a2f01635 100644 --- a/files/en-us/web/api/htmloptionscollection/index.md +++ b/files/en-us/web/api/htmloptionscollection/index.md @@ -13,13 +13,20 @@ The **`HTMLOptionsCollection`** interface represents a collection of [`