fastn by default creates the URL based on the file path of a document, eg / corresponds to index.ftd and /docs/ looks for both docs.ftd and docs/index.ftd.

This ties URLs with folder heirarchy.

This can cause some issues with organisation, as SEO and clean URL people want URLs to not have meaningless information, like your folder heirarchy.

URLs are good, for example for fastn.com, we have a processor called http processor and we often want to link to it using fastn.com/http/ which is short and easily memorisable. But the document we store is in ftd-host/http.ftd based on our organisations guidelines.

But you do not want to put all the documents on the top level, as without folder heirarchy it becomes hard to navigate.

fastn is configured using a file called FASTN.ftd, where you can define a sitemap of your site.

Normally your sitemap may look like this.

-- fastn.sitemap:

- Home: /
- Docs: /docs/

-- fastn.sitemap:

- Home: /
- Docs: /docs/

-- fastn.sitemap:

- Home: /
- Docs: /docs/
  document: documentation.ftd

-- fastn.sitemap:

- Home: /
- Docs: /docs/
  document: documentation.ftd