Write HTML Right

#1

Post by aparks517 » Fri, Jun 10, 2022, 2:39 PM UTC

Re: Write HTML Right

#2

Post by kuschku » Fri, Jun 10, 2022, 3:01 PM UTC

I appreciate that this blog post itself is written in the exact same style! I really miss being able to read the view-source: version of websites easily, but this blog post does it well :)

Re: Write HTML Right

#3

Post by sylware » Fri, Jun 10, 2022, 3:04 PM UTC

Regarding tables, there is one trick: size of borders are actually weighted semantic separators, and should be in HTML, not in CSS.

Re: Write HTML Right

#4

Post by Julesman » Fri, Jun 10, 2022, 3:16 PM UTC

sylware wrote: post #3

Regarding tables, there is one trick: size of borders are actually weighted semantic separators, and should be in HTML, not in CSS.

Regarding tables, don't use tables. :)

Re: Write HTML Right

#5

Post by btrettel » Fri, Jun 10, 2022, 3:19 PM UTC

Regarding writing "one-sentence-per-line", I've noticed that style before in LaTeX. While I don't use that style, one advantage that I like is the ability to include comments on the sentence level in LaTeX.

So instead of this:

  First sentence. Second sentence. % Comment on first sentence.

I can write:

  First sentence. % Comment on first sentence.
  Second sentence.

(Of course, one could define a new TeX macro that doesn't display anything to add comments anywhere in-line. That's not as readable, though.)

I've also read that one-sentence-per-line works better with diff programs, but I haven't had any problems with the program meld, so this isn't convincing to me. The advantage the linked article mentions in terms of rearranging sentences also is worth considering, though I haven't found the normal way to be that bad so I'm not convinced by that either.

Some other links on this coding/writing style:

https://rhodesmill.org/brandon/2012/one-sentence-per-line/

https://news.ycombinator.com/item?id=4642395

http://www.uvm.edu/pdodds/writings/2015-05-13better-writing-...

Re: Write HTML Right

#6

Post by Rygian » Fri, Jun 10, 2022, 3:20 PM UTC

Julesman wrote: post #4

sylware wrote: post #3

Regarding tables, there is one trick: size of borders are actually weighted semantic separators, and should be in HTML, not in CSS.

Regarding tables, don't use tables. :)

Except, you know, for actual tables. :-)

Re: Write HTML Right

#7

Post by robgibbons » Fri, Jun 10, 2022, 3:21 PM UTC

This works for blog posts, where the body of the document is one long block of paragraphs, but I suspect this style would quickly become untenable for complex apps. Indentation _is_ information, which is lost here.

Re: Write HTML Right

#8

Post by egeozcan » Fri, Jun 10, 2022, 3:23 PM UTC

robgibbons wrote: post #7

This works for blog posts, where the body of the document is one long block of paragraphs, but I suspect this style would quickly become untenable for complex apps. Indentation _is_ information, which is lost here.

> Indentation _is_ information, which is lost here.

Isn't it a "view" of information? Any sufficiently advanced text editor can recreate it with a simple key combination.

Re: Write HTML Right

#9

Post by jahewson » Fri, Jun 10, 2022, 3:27 PM UTC

robgibbons wrote: post #7

This works for blog posts, where the body of the document is one long block of paragraphs, but I suspect this style would quickly become untenable for complex apps. Indentation _is_ information, which is lost here.

Incorrect indentation is therefore misinformation.

Re: Write HTML Right

#10

Post by aparks517 » Fri, Jun 10, 2022, 3:27 PM UTC

robgibbons wrote: post #7

This works for blog posts, where the body of the document is one long block of paragraphs, but I suspect this style would quickly become untenable for complex apps. Indentation _is_ information, which is lost here.

I've been using this style - with some tweaks - for web apps too. I don't think I have it completely figured out yet, but it's promising so far. You can view the source of http://lofi.limo/ to see how it's working out.