Tags: UI/UX

Every document has a directory. A Directory is the logical representation of a nested structure of names in Site.

A path route identifies a directory and a document at the same time. Path /cars is a document /cars and a directory or /cars/honda and /cars/toyota. Both things are optional: there could be nothing in the directory or no document. If there’s no document and nothing in the directory, then this path doesn’t exist.

Example:

We could have names cars/toyota and cars/honda in our namespace but nothing named cars. This way when a user navigates to /cars there’s no document under this name. But we can show a “virtual” document listing the underlying cars/toyota and cars/honda documents.

We could also indeed have a document named cars, in which case we could render both the document cars and the directory of cars/* on the same page.

It’s important that the document cars has no relationship to document cars/toyota or cars/honda. It’s not more important, it’s not a parent, and doesn’t enforce anything on other document sharing the same name prefix.