3 ms·
"Assume readers know the basics or will look them up ..." I am taking a different approach with a new form I am experimenting with - the "Iceberg Article": ht
by rsync 5y ago
"Assume readers know the basics or will look them up ..."
I am taking a different approach with a new form I am experimenting with - the "Iceberg Article":
https://john.kozubik.com/pub/IcebergArticle/tip.html https://john.kozubik.com/pub/IcebergArticle/tip.html
The idea is that there are two complete treatments of the subject - the "tip" which is highly compressed and the "body"[1] which is fleshed out with notes, pictures, examples, subscripts, etc.:
"In this way, a concise and complete treatment of a subject can serve as a gateway to an extremely deep and rich well of content that does not distract from the parent work."
[1] Yes, I did start off properly referring to it as a "bummock" but I got sick of both reading and writing that word.
- spurgu 5y agoFYI getting a certificate error there.
- maxwelljoslyn 5y agoAlways happy to see someone writing in a hierarchical format. Maybe one day everyone will wake up and start writing Engelbart-style tree documents[1]. Site feedback for you, John: I would appreciate if you linkified your name (in the header of the page), as well as the path "breadcrumbs" at the right hand side of the header. Otherwise I'm stuck chopping things out of the URL by hand to try and go up the path. [1] For instance, see this online copy of "Augmenting Human Intellect" (AHI). https://dougengelbart.org/content/view/138/ https://dougengelbart.org/content/view/138/ Notice how all the paragraphs are explicitly arranged in a hierarchy. At Engelbart's research lab, all documents were circulated in such a format ... even public releases like AHI ... and they had software with capabilities similar to today's org-mode, or Workflowy, or Vim folds which let researchers browse/edit code and text with respect to the hierarchy ... I highly recommend reading the linked report.