Links

The basis of the main data element in SHC is the link.

A link consists of a title, a description, and a URL.

The description field is stored as Markdown formatted plain text.

The link's creation & modification date are stored.

For items linked to upstream sources, the link's last sync date is stored.

For synced links, the modification date is only changed if an upstream edit is applied (i.e. only if a change actually occurred, not just a sync event).

Links have a local permalink. Whether local permalinks are displayed / visitable is up to design & configuration. For configuration, there is a per-link-type config setting -- "Make local permalinks visitable". If set to TRUE, then each link's local permalink (e.g. /link-type/view/LINKID) will be visitable / search engine crawlable. If set to FALSE, then such links will return an HTTP status code 403/404.

TO DO set / indicate "canonical" URL that the link is sourced from? If done correctly, various tag and overview pages should rank highly in search, but we want the "source" canonical URLs to be shown as the primary.