2026-02-03 10:48:20 HTML is terrible 2026-02-03 10:51:53 veltas, maybe but I've become used to it writing project doc in Fossil DCVS wikis 2026-02-03 10:52:14 veltas, I prefer it to Martkdown 2026-02-03 10:53:59 veltas, but my preffered language is py.sphinx (.rst) which my Mecrisp-Stellaris Unofficial Doc site is written in 2026-02-03 10:54:07 HTML has essentially taken over formatted documents for many purposes, yet it lacks even the most basic typographical features e.g. there's no way to leave extra space between sentences without a lot of CSS gymnastics or incorrect   use 2026-02-03 10:54:29 It's crept into email too somehow, again not really capable for the basic jobs in email 2026-02-03 10:56:58 yes, it's got it's problems, and passed one onto me! When I was putting in heaps of HTML editing to finish the release of FURS, my mouse gave me 'trigger finger' because HTML is so 'busy' 2026-02-03 10:57:24 Plain text goes pretty far for a lot of technical documentation, if you want more then there's troff and LaTeX et al, or you can render stuff yourself or with vector / font libraries 2026-02-03 10:57:32 I wouldnt have got that writing py.sphinx doc 2026-02-03 10:58:26 Ive written tons of Tex and LaTex, even a 'screenwriting' class file 2026-02-03 10:59:02 but LaTeX is too 'bookish' or 'acadmic' for web work 2026-02-03 11:00:17 and text is just dead boring for websites (imho) and lacks everything that py.sphinx offers, such as indexes, references, etc 2026-02-03 11:01:34 Ive spent half my life writing doc and Ive tried just about everything, but py.sphinx is the python official doc system, and it's really good. Ive been using it for about the last 5 years 2026-02-03 11:02:42 sadly Fossil DCVS which is my favorite way of distributing projects now, only uses Fossil Wiki HTML 2026-02-03 11:02:59 oe text or Markdown 2026-02-03 11:03:31 Some larger text documents I've seen use conventions to allow you to index them using regex, like formatting section headers a certain way 2026-02-03 11:03:45 So you can go to e.g. ^6.0 section 2026-02-03 11:04:05 But that's less usable for general people 2026-02-03 11:04:54 My issue is that HTML has ended up being a centre of typography in our world, even though it was sort of 'anti-typography' when it was designed originally 2026-02-03 11:16:25 veltas, true, HTML is for web pages, it's unsuited for proper documantation 2026-02-03 11:17:04 And yet it's where a lot of 'proper documentation' ends up 2026-02-03 11:17:18 py.sphinx can churn out a mumber of formats such as epub, html, pdf etc, all from the same source 2026-02-03 11:17:42 It's an interesting question to me how you could redesign the web in a simpler and more forthy way, and I've discussed it on here before 2026-02-03 11:18:05 But I think most of us agree the web is sort of a rich terminal sandbox 2026-02-03 11:18:18 so I just edit in .rst and compile HTML in py.sphinx and RSYNC to my website. Its so easy it should be illegal :) 2026-02-03 11:19:29 crc, has a excellent doc system he uses for his RETRO Forth, it's his own design I believe 2026-02-03 11:19:53 I'd do something like that if I was real programmer :) 2026-02-03 11:20:43 To put it short, to me, HTML is much like English: sure, I'd have preferred writing Esperanto instead, but the thing is, people that may be interested in what I write are much more likely to read English than Esperanto. (Reminds me of http://fimfiction.net/story/390596/1/ , I guess.) 2026-02-03 11:20:43 Other than that, I can see that HTML is used in ways that are in fact "anti-HTML." For instance, HTML was designed for interoperability; using HTML as a mere "bootloader" of sorts for a