Note to self: feedback from earlier draft

[gordonbrander]

trafficstars

Just dropping a link to old gist feedback from first draft for myself https://gist.github.com/gordonbrander/9ff60443ddb28e0403b0c6b41a473cd8

👆 If you have feedback, please open an issue, rather than commenting on this gist.

[gordonbrander]

Gozala's notes https://via.hypothes.is/https://gist.github.com/gordonbrander/9ff60443ddb28e0403b0c6b41a473cd8

[gordonbrander]

From Gozala:

Link blocks (lines starting with &) allow you to link to other files within the flow of a Subtext document

I’m more and more convinced that 1:1 mapping has been a mistake. Have you considered links that point to multiple sources? That way user agent can decide what is the best place to get it from. Part of me wishes links were hashes followed by URLs where you can grab those from.

Addressed in https://github.com/gordonbrander/subtext/pull/14, where we introduce multilinks.

[gordonbrander]

From Gozala:

& punctuated-equilibrium.st

Part of the struggle I have with markdown and HTML is: I want some terms in the body of text to be links, but here is the dilemma

• Do I turn all occurrences of these term into a link ?
• Do I turn a single occurrence of the term into a link, then which one ?
• Different terms are used to refer to the same thing should they all be links to the same thing ?

I think idea of just listing link/references separately is neat as it avoids those questions. On the other hand it also no longer communicates connection a thing link is in reference of. In an ideal world I wish hovering a link provided a sort of heatmap of what it’s related to.

Somewhat relatedly, https://github.com/gordonbrander/subtext/pull/14 introduces optional link labels, which could be interpreted as labels for edges in the node graph of links.