could use more graphics
EDIT press F5 if you dont get nice diagrams
The “voice” seems to change quite abruptly in places. One minute its addressing folk who barely have the concept of a TV remote and the next its calling methods. I’m sure that can get sorted.
This is an excellent foundation to build proper documentation on.
Perhaps a “gentler” overview could be quickly extracted from this for near n00bs
More pics, less code and more rigorous docs with full code commentary created later .
If every IF project generated docs with this tool, it would be interesting to see how common concepts are handled.
Will we see the same boilerplate for say Scratchpads ?
Verse 1: The Data’s Journey "O’er wires an’ waves the bytes do flee, Like wee birdies takin’ wing sae free. The Client, wise as auld Lochlea, Self-encrypts wi’ care: To chunks it breaks, sae sma’ an’ tight, While DataMaps blaze wi’ crypted light— A ledger fair for a’ tae see, Or hide, should ye dare."
Verse 2: The Public Way "When data’s bared for public ken, Yon Map’s address is ta’en again. It joins the flock on network’s glen, Nae mair than a chunk. But fetch it back wi’ ‘get’ sae keen, An’ a’ the pieces soon convene— Like sheaves o’ corn at harvest’s end, To wha’ holds the trunk."
Verse 3: The Private Path "Yet hid frae licht, like gowd in stream, The Private Map’s a treasured dream. Ne’er cast upon the network’s scheme, But kept close an’ dear. Wi’ ‘data_get’ ye wield its might, To summon chunks back intae sight— For nane but ye wha’ own the key May ever draw near!"
Moral (Final Stanza) "So mark ye weel this DataMap art, Twa paths diverge frae one smart start: An’ mind!—the choice that sets apart The open frae the sealed. For public shares wi’ a’ the land, But private stays in thy ain hand, Like love or freedom, dearly planned, Or seeds in Springtime’s field."