New docs area for URL semantics, relocate some HTTP pages here #35202

Josh-Cena · 2024-07-28T19:36:16Z

I assume I have gotten enough support in https://github.com/orgs/mdn/discussions/700, so this is the first part of the proposal. I have created a new "URL" area, and moved a few HTTP pages that talk about URLs here.

files/en-us/web/url/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

github-actions · 2024-07-28T19:37:44Z

Preview URLs (37 pages)

Flaws (18)

Note! 31 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/Fenced_frame_API
Title: Fenced Frame API
Flaw count: 1

macros:
- /en-US/docs/Web/API/Navigator/runAdAuction does not exist

URL: /en-US/docs/Web/HTTP/Basics_of_HTTP
Title: Basics of HTTP
Flaw count: 5

macros:
- /en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not exist
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
broken_links:
- Can't resolve /en-US/docs/Web/HTTP/Frame_and_message_structure_in_HTTP_2
- Can't resolve /en-US/docs/Web/HTTP/Connection_management_in_HTTP_2

URL: /en-US/docs/Web/HTTP/Headers/Content-Security-Policy/frame-ancestors
Title: CSP: frame-ancestors
Flaw count: 3

macros:
- /en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not exist
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs

URL: /en-US/docs/Web/HTTP/Headers/Content-Security-Policy/Sources
Title: CSP source values
Flaw count: 3

macros:
- /en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not exist
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs

URL: /en-US/docs/Web/HTTP/Session
Title: A typical HTTP session
Flaw count: 3

macros:
- /en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not exist
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs

URL: /en-US/docs/Web/HTTP/Status/421
Title: 421 Misdirected Request
Flaw count: 3

macros:
- /en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not exist
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
- Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs

External URLs (6)

URL: /en-US/docs/Web/OpenSearch
Title: OpenSearch description format

https://software.hixie.ch/utilities/cgi/data/data (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/Canvas_API/Tutorial/Pixel_manipulation_with_canvas
Title: Pixel manipulation with canvas

https://en.wikipedia.org/wiki/Portable_Network_Graphics (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/URI/Authority
Title: URI authority

https://en.wikipedia.org/wiki/Semantic_URL_attack (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/URI/Fragment
Title: URI fragment

https://www.w3.org/TR/media-frags/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/URI/Schemes
Title: URI schemes

https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts
Title: Content scripts

https://bugzil.la/1411641 (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2024-08-26 15:29:45)

files/en-us/web/url/index.md

files/en-us/web/uri/authority/index.md

files/en-us/web/uri/schemes/index.md

files/en-us/web/uri/index.md

hamishwillee · 2024-08-19T01:10:26Z

The sidebar's far from pretty, but I think it makes sense.

Agreed. At least all the docs are present and it gives us a baseline for discussion. I'm happy enough with it.

There are a couple more suggestions there, but I think this is good. Let's see if we can also get review from @bsmth (I'll approve tomorrow)

Co-authored-by: Hamish Willee <[email protected]>

hamishwillee

@bsmth Can you scan this. I think it is good, but extra eyes would be welcome.

@Josh-Cena Approved, but would be good to give Brian a chance to look at it if he is available today.

files/en-us/web/uri/index.md

Co-authored-by: Brian Thomas Smith <[email protected]>

bsmth · 2024-08-26T15:07:24Z

files/en-us/web/uri/index.md

+
+Any of those URLs can be typed into your browser's address bar to tell it to load the associated page (resource).
+
+A URL is composed of different parts, some mandatory and others optional. A more complex example might look like this:


Do you want to mention that the parts of a URL are described in detail below?

I think this is fine as-is. The details below aren't directly dependent on this example anyway.

files/en-us/web/uri/schemes/index.md

bsmth

Thanks a lot, Josh & Hamish. I'm also +1 on this with some minor nits. Also agree about sidebar improvements, but this is a great start

Co-authored-by: Brian Thomas Smith <[email protected]>

Josh-Cena · 2024-08-26T15:41:53Z

Thanks to you both for the reviews!

ref: mdn/content#35202

* zh-cn: sync translated content * Move URL related docs to the new area ref: mdn/content#35202 --------- Co-authored-by: allo <[email protected]>

* zh-tw: sync translated content * Move URL related docs to the new area ref: mdn/content#35202 --------- Co-authored-by: allo <[email protected]>

bsmth · 2024-08-27T13:14:44Z

BTW @Josh-Cena there's some fixes to be done on sidebars: mdn/yari#11700

At the moment, adding the links to the new locations, but we should have a think if it makes sense to have these entries here at all (under Resources and URIs).

Josh-Cena · 2024-08-27T14:41:05Z

Great, thanks!

I don't have any opinions on how the HTTP sidebar should be structured.

New docs area for URL semantics, relocate some HTTP pages here

eba34f1

Josh-Cena requested review from a team as code owners July 28, 2024 19:36

Josh-Cena requested review from jpmedley, Elchi3 and estelle and removed request for a team July 28, 2024 19:36

github-actions bot reviewed Jul 28, 2024

View reviewed changes

files/en-us/web/url/index.md Outdated Show resolved Hide resolved

Update files/en-us/web/url/index.md

7c3fddf

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Change intro

020badf

Josh-Cena force-pushed the url-area branch from a986916 to 020badf Compare July 28, 2024 19:47

bsmth reviewed Aug 1, 2024

View reviewed changes

files/en-us/web/url/index.md Outdated Show resolved Hide resolved