Documentation: The Hydra Problem OR Not
98 views
Skip to first unread message
@TiddlyTweeter
Jul 2, 2018, 1:04:52 PM7/2/18
to TiddlyWiki
Mark S. Wrote: "It would be great to write up an all-up tutorial, but like attacking a hydra, where do you begin?"
Cope with the LERNAEAN HYDRA? Its a great question. Highly relevant.
Looking BROADLY at the docs it can seem like an an engagement where the penitential documenter takes on the role of SISYPHUS. A Hydra tamer in for several thousand iterations and needing final Extreme Unction. But over Herculean, I think.
So is it really that? The Hydra Route is battle.
What other easier routes exist more easily?
Cope with the LERNAEAN HYDRA? Its a great question. Highly relevant.
Looking BROADLY at the docs it can seem like an an engagement where the penitential documenter takes on the role of SISYPHUS. A Hydra tamer in for several thousand iterations and needing final Extreme Unction. But over Herculean, I think.
So is it really that? The Hydra Route is battle.
What other easier routes exist more easily?
Mark S.
Jul 3, 2018, 12:48:15 AM7/3/18
to TiddlyWiki
But it gets worse -- science now tells us that hydras may never die: https://www.livescience.com/53178-hydra-may-live-forever.html
It would be really nice if all hydras accidentally exposed their undersides like the one (ones?) in the video.
-- Mark
On Monday, July 2, 2018 at 10:04:52 AM UTC-7, @TiddlyTweeter wrote:
It would be really nice if all hydras accidentally exposed their undersides like the one (ones?) in the video.
-- Mark
On Monday, July 2, 2018 at 10:04:52 AM UTC-7, @TiddlyTweeter wrote:
Arlen Beiler
Jul 3, 2018, 7:32:17 AM7/3/18
to tiddl...@googlegroups.com
Any Hydra may be inspected from a safe distance by pressing F12. However, the system does not show everything yet.
--
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/8c5dde52-5773-4e2f-ac1b-ae529e383842%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
@TiddlyTweeter
Jul 3, 2018, 7:40:20 AM7/3/18
to TiddlyWiki
Something else you wrote about documentation I found very good ...
Mark S.
It strikes me that thinking into the various types of "exceptions" and explaining them first could be a godsend.
For instance, I find that quite often something does not work as I expect NOT because I got the "code" wrong so much as that I got the layout wrong in some way that I wasn't clear about. "Blank lines" in TW and how they work still often catches me out.
One thing that people who have more experience than me have is "Implicit Knowledge of Exceptions" and "quirks you need to grasp". I think Explicating those could be immensely useful. In exactly the same way as, for instance, in teaching English, you use can use exceptions to highlight more regular rules.
Mark S.
TW technology is more like learning a human language than a programming language -- there's a handful of rules and then a whole lot of exceptions.
It strikes me that thinking into the various types of "exceptions" and explaining them first could be a godsend.
For instance, I find that quite often something does not work as I expect NOT because I got the "code" wrong so much as that I got the layout wrong in some way that I wasn't clear about. "Blank lines" in TW and how they work still often catches me out.
One thing that people who have more experience than me have is "Implicit Knowledge of Exceptions" and "quirks you need to grasp". I think Explicating those could be immensely useful. In exactly the same way as, for instance, in teaching English, you use can use exceptions to highlight more regular rules.
Reply all
Reply to author
Forward
0 new messages