Why single quotes?

[Rant; feel free to ignore] FWIW this is why I don't like the current IA. The sections below are supposed to be the list of links, but organized in a more organic way, rather than as an uninteresting, unordered list. The URI docs are supposed to be cut by the components, just like API docs are primarily cut by APIs, not by reference/guide.

Why single quotes?

Updated in b16ae2a which I think is a bit clearer.

this is why I don't like the current IA. The sections below are supposed to be the list of links, but organized in a more organic way, rather than as an uninteresting, unordered list. The URI docs are supposed to be cut by the components, just like API docs are primarily cut by APIs, not by reference/guide.

No I appreciate sharing - those are rough edges -> these changes in particular highlight when a landing page for a technology/topic lists everything (all guides & references), then a guide / reference page duplicates a subset of that, it's not so elegant, I agree. At the least, the reference and guide pages should be exhaustive.

For cutting by URI component, do you mean it would be better to have:

./files/en-us/web/uri
├── authority
│   ├── guides
│   └── reference
├── fragment
│   ├── …
│   └── reference
└── schemes
    ├── …
    └── reference

v

./files/en-us/web/uri
├── guides
│   └── choosing_between_www_and_non-www_urls
└── reference
    ├── authority
    ├── fragment
    │   └── text_fragments
    └── schemes
        ├── data
        ├── javascript
        └── resource

https://github.com/mdn/content/tree/main/files/en-us/web/uri/reference

For cutting by URI component, do you mean it would be better to have:

Yes that's what I meant.

I guess we could do - currently the section is a little light on content so it's hard to see much of a difference, but this is not a bad way to organize it, indeed.

I don't think it's productive to change everything again—I can live with the current organization. I think if the other sections on the main landing page (URI vs URN & URI structure) get moved it would look a lot cleaner.

Let's revisit this

(URI vs URN & URI structure) get moved it would look a lot cleaner

Definitely, these are some leftovers that we can tidy and flesh out properly.

edit: I understand the suggestion, I'll try tidy the landing page in this PR.

Perhaps move this thing to "reference"? It's supposed to be a list of links.

There were many side effects of moving this, see 54b4e6e

Who resolves the NID? Perhaps some usage context would be useful (you may do that in a follow up, not a big blocker)

Added basic hints here 5cbb5d2

Noting that this page needs love anyway, it's missing the optional components: