search

subconsciousnetwork / subtext

Markup for note taking
Apache License 2.0
271 stars 20 forks source link

Note to self: feedback from earlier draft #1

Open gordonbrander opened 3 years ago

gordonbrander commented 3 years ago

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 commented 3 years ago

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

gordonbrander commented 3 years ago

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 commented 3 years ago

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.