News for hackers. Stuff that matters.
Re:On Semicolons and the Rules of Writing by codesections on Saturday July 14, 2018 @09:11AM (#17530201)
Semicolons can also be extremely helpful for lists with internal punctuation, especially in technical writing. I recently wrote the following sentence in some documentation:

  By default, Gutenberg will look for three templates:
  index.html, which is applied to the site homepage; 
  section.html, which is applied to all sections (any 
  HTML page generated by creating a directory within 
  your content directory); and page.html, which is 
  applied to all pages (any HTML page generated by 
  creating a .md file within your content directory).
Omitting semicolons from that sentence would have made it much harder to understand, at least in my view.
Re:On Semicolons and the Rules of Writing by auxym on Saturday July 14, 2018 @09:47AM (#17530330)
Whenever I find myself writing lists in technical writing, I seriously consider if I can express that information in a table or bullet list.
Re:On Semicolons and the Rules of Writing by cirgue on Saturday July 14, 2018 @11:33AM (#17530701)
Technical writing is a bit of a different beast: you’re writing both to instruct first-time readers and to serve as an authoritative reference for people who have read the document or are otherwise already familiar with the subject.
Re:On Semicolons and the Rules of Writing by ghaff on Saturday July 14, 2018 @10:02AM (#17530383)
That's a good point. In general prose, I try to avoid a lot of lists and tables precisely because it sort of screams "manual" or something else dry. But, I agree, that it's often easier to parse a bullet list especially in technical writing and other straightforward communication of information.
Re:On Semicolons and the Rules of Writing by logicallee on Saturday July 14, 2018 @11:47AM (#17530771)
you mention quite a formal list (introduced by a colon) but it also serves well in simple lists:

The dinner was attended by Ms. A, the President of the Board of Education, Mr. B, the Vice-President, and other dignitaries.

Becomes much clearer when expressed

The dinner was attended by Ms. A, the President of the Board of Education; Mr. B, the Vice-President; and other dignitaries.

and is allowed in this construct though rare. Basically, whenever there is a comma inside a comma-separated term you can turn the higher-level commas into semicolons to indicate this. Makes things super-clear.

Re:On Semicolons and the Rules of Writing by ghaff on Saturday July 14, 2018 @09:40AM (#17530297)
Personally, I'd probably have used parentheses for the dependent which clauses rather than commas. But, yes, there are situations where you have lists of things that sometimes have to embed commas and then it makes sense to separate the items with semicolons.
Re:On Semicolons and the Rules of Writing by dfee on Saturday July 14, 2018 @01:34PM (#17531307)
I never thought of using the semicolon for the purpose of delimiting descriptive lists.

As opposed to some sibling comments, which express that bullets should instead be used, I think this offers a good alternative.

Re:On Semicolons and the Rules of Writing by anonoholic on Saturday July 14, 2018 @11:57AM (#17530820)
The article is talking specifically about the use of the semicolon creative writing.