For first theme I stupidly used all these html, css, images folder, etc. You know, it was overloaded, not elegant looking. Then I realised the scale of stupidity and now prepare PDF documentation only.
I as if did not notice your ungrounded sarcasm, I forgive you.
The question: how do you cope with things you forgot to add? For me it was the main point why I switched to html. Let’s say, I wrote a file, submitted template and in a day or two realised that something was forgotten. To bother TF team with reuploading the file is not very convenient, at least I feel so.
Second thing: if you need to add some code example, how do you do that? I use js highlight script, for me it looks and works better than plain copied/pasted piece of code.
Third thing, PDF does not allow embedded video, right? If you need to add some video tutorial– explanation you can place only link, not video itself, do you find it more effective?
I also use js smooth scroll for navigation and “to the top” button (like in websites), I think it makes a boring reading of documentation a little bit more comfortable (and even entertaining) for a customer.
As for elegance, well, depends how you make your html file. Mine I tried to make not less attractive and beautiful than a template itself.