Hacker News Reader

Comment by Washuu | Hacker News Reader

Thank you for the help. It is really frustrating when authors do not define an acronym when it is first introduced in the text.

View on HN

But they do:

> The part of the system that manages all this mess is called Windows Security Center - WSC for short.

It needs to be closer to where the acronym is first introduced. The definition, on my screen, is below the fold so it can not be seen in context of where the acronym is first introduced. If it was defined below the title, I would understand.

* https://apastyle.apa.org/style-grammar-guidelines/abbreviati...

* https://www.stylemanual.gov.au/grammar-punctuation-and-conve...

* https://learn.microsoft.com/en-us/style-guide/acronyms

I do a lot of copy editing for clarity and non-native speakers so I have keep these things in mind. ¯\_(ツ)_/¯

This is a somewhat useful feedback, however I am not too sure how this can be fixed given the structure of my blog post. Do you think if I just add a line `*WSC is short for Windows Security Center` in the first paragraph this will be enough?

My suggestion:

In this post I will briefly describe the journey I went through while implementing defendnot, a tool that disables Windows Defender by using the Windows Security Center (WSC) service API directly.

thank you! i changed the first paragraph to include these changes

Ah that makes sense. I saw this subthread and was quite confused because WSC was clearly and obviously defined in the first sentence.

Now I see why. Thanks for incorporating the feedback! It had a positive impact for me coming later to this article.

Appreciated, thank you!~ \(￣︶￣*\))

Or use the abbr (and its title attribute) that was designed for that purpose; no extraneous "flow" breaking required. Mobile people can long press on the indicator to read more, everyone who magically knew what WSC gets to continue to know what WSC means

https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/...

The typical solution, is to include the expansion in brackets after the first use.

Simple rule I learned on my Electronic Engineering degree (where we're guilty of many, many acronyms): When you write an acronym/initialism in a paper (or anywhere for others to read reall), assume the reader doesn't know what it stands for and include the expansion in brackets immediately after the first use.

EDIT: As my sibling comment also suggests, writing it in full the first time, and using the acronym/initialism in brackets is also acceptable.

Just wondering is this Slack? Just wondering what kind of logging flow you’re using.

https://blog.es3n1n.eu/posts/how-i-ruined-my-vacation/pics/p...

Looks like Discord.

this is discord in "Compact" theme

At least that one is defined later on. I'm still scratching my head over "CTF".

[Edit - could be Capture The Flag?]

You're right, that never gets defined. Yes, Capture The Flag cybersecurity sort of competition I think

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

They do. They understandably shorten it in the title, but then they define the acronym the first time they use it in the article.

Reply on news.ycombinator.com