News for hackers. Stuff that matters.
Re:Technical Writing for Developers by gaws on Friday July 15, 2022 @03:51PM (#32112063)
> Technical writer with 10 years of experience.

What's an easy-to-remember trick for semicolon usage?

Re:Technical Writing for Developers by lcnPylGDnU4H9OF on Friday July 15, 2022 @04:20PM (#32112318)
Consider when you have two distinct statements that are related but the former does not necessarily lead into the latter; a semicolon is appropriate in such an instance.

Alternatively, just don't bother and use two sentences.

Re:Technical Writing for Developers by mcbishop on Friday July 15, 2022 @04:46PM (#32112622)
I like to use a long dash instead. It gives the two statements more breathing room.
Re:Technical Writing for Developers by wmeredith on Friday July 15, 2022 @05:09PM (#32112847)
It's called an em dash. It's a dash the width of the "M" glyph.

https://www.thepunctuationguide.com/em-dash.html

Re:Technical Writing for Developers by rozenmd on Saturday July 16, 2022 @04:29AM (#32116210)
No one really cares.

You're not going to lose a reader over semicolon misuse if you're solving a problem for them.

Re:Technical Writing for Developers by rpmisms on Saturday July 16, 2022 @01:19AM (#32115428)
Dev with a flair for writing over here. Using semicolons is a good practice for separating clauses, especially if you're being verbose

My mother gave me my first car; it was an beautiful 2002 Honda Civic with a falling-off bumper and bald tires.

You could replace the semicolon with a comma thus:

My mother gave me my first car, a beautiful 2002 Honda Civic with a falling-off bumper and bald tires.

That feels a little more natural, but is harder to read accurately.

It's useful in legal and technical writing, but not necessarily great for everyday life. Personally, I don't really use semicolons; you may have different opinions on their usage.

It's basically an arrow in text.

this -> that

as opposed to a comma, which feels more like

this and also that

Re:Technical Writing for Developers by gaws on Saturday July 16, 2022 @03:57PM (#32121392)
> Using semicolons is a good practice for separating clauses, especially if you're being verbose

Can't a period do that?

Re:Technical Writing for Developers by rpmisms on Sunday July 17, 2022 @10:45PM (#32133996)
Yep. Sometimes that feels too abrupt, though. Even if you're trying to be pointed.
Re:Technical Writing for Developers by hluska on Saturday July 16, 2022 @12:52AM (#32115315)
I like using these two ‘jokes’. Neither of them are actually funny, but they help (me).

- What is the difference between a semicolon and a cat??

One has a pause at the end of its clause. The other has claws at the end of its paws.

- What happened when the semicolon broke grammatical rules??

It got two consecutive sentences.

—-

All that said, it’s usually better not to. There aren’t really many cases in modern English where a semicolon is necessary. And there are even fewer cases where a semicolon provides a more clear expression than two sentences. In practice, they’re most often part of really badly disjointed ‘sentences’.

Re:Technical Writing for Developers by xboxnolifes on Friday July 15, 2022 @04:03PM (#32112166)
Don't use it.
Re:Technical Writing for Developers by wmeredith on Friday July 15, 2022 @05:12PM (#32112869)
Haha. Well said.

My mother has a PHD in English Literature and has taught languages and writing in college for decades. She's also a book editor and an author with published works from picture books for children to graduate-level text books. She tells me that the semi-colon's primary use is to let the reader know that the author attended college. Just use a period.

Re:Technical Writing for Developers by halfnormalform on Friday July 15, 2022 @08:04PM (#32114047)
As T.S. Eliot said, great writers steal. That’s Kurt Vonnegut’s joke!
Re:Technical Writing for Developers by infogulch on Friday July 15, 2022 @05:50PM (#32113188)
Don't use it; or do, I'm not your English teacher.
Re:Technical Writing for Developers by bombcar on Saturday July 16, 2022 @01:13AM (#32115414)
I only use it as an upgraded comma. The options are red, green, blue; cyan, magenta, yellow, black; or black and white.
Re:Technical Writing for Developers by layer8 on Friday July 15, 2022 @07:32PM (#32113850)
You mean in JavaScript? ;)