3 ms·

Please, if you have to use an abbreviation in your title, define it in the synopsis. If you use an abbreviation in audio/video, use the unabbreviated term first

Please, if you have to use an abbreviation in your title, define it in the synopsis. If you use an abbreviation in audio/video, use the unabbreviated term first and the abbreviation immediately after. I’ve never heard of DAG, yet it’s used as if it’s commonplace.

0xdeadb00f 4y ago
I thought they meant Directed Acyclic Graph [0]. [0]: https://en.wikipedia.org/wiki/Directed_acyclic_graph https://en.wikipedia.org/wiki/Directed_acyclic_graph
unglaublich 4y ago
You have to make some assumptions about what is common knowledge in your target audience. Probably, the author didn't design the title for a general public on HN, but for Getz' fellow software UI researchers. Someone that's not in the target audience will have to do some extra work to get up to speed. Just like an undergraduate will have a hard time understanding a graduate text without a primer.
DerSaidin 4y ago
Should they have defined UI? Should they have defined DB? It is subjective where to draw the line for commonplace, and it depends on the audience. Is DAG a commonplace acronym for people attending HYTRADBOI? Maybe (I see 2 other talks mentioning graphs/trees in their title).
- alpaca128 4y ago
  It costs nothing to use the full term once or twice. It can prevent confusion, and some people in the audience may not know the concept and googling a few letters is often not the best way to get useful results. Saving a couple syllables in a talk isn't worth it.
arinlen 4y ago
> I’ve never heard of DAG, yet it’s used as if it’s commonplace. DAG, as in direct acyclic graph, is indeed a basic concept of computer science. But indeed the author could do a better job with the text. One of the very basic principles of technical writing is to always introduce the definition when an acronym is first presented, something like "blablabla a direct acyclic graph (DAG)".
- mananaysiempre 4y ago
  Wouldn’t really call it a “basic principle”: as with anything else, it really depends on what you assume your audience knows (and you will need to make assumptions about that). If you are describing advantages of your new CRDT over past ones, most likely expanding that into “conflict-free replicated data type” will not help any of your readers; if you’ve come to a statistical physics lecture, “BBGKY hierarchy” might be even more evocative than Bogoljubov-Born-Green-Kirkwood-Yvon (seriously, I know the concept but just had to look up one of the surnames). Of course, it’s possible to speak about either of those things without assuming this knowledge, but this is then a very different talk, most of which will be useless to most of the people who do already have it (not all—it’s useful to occasionally read introductory stuff on topics you think you know!). This is essentially the same thing as power-user usability: it can and does evolve into gatekeeping if left unchecked, and a fresh perspective is a useful check, but assuming everyone is a novice is not the right approach either. (Some mathematics books choose the worst of both worlds: you really do need to know X to read this book, but “to make this book self-contained” we just included a short two-chapter summary of X that instills horror in anyone who doesn’t know it and forces everyone who does to dig through every word searching for conventions or non-standard assumptions. I’ve been in both categories, sometimes simultaneously. On the other hand, other introductory sections of this kind are remarkably crisp summaries that I go around recommending to everyone.)
  - arinlen 4y ago
    > Wouldn’t really call it a “basic principle”: as with anything else, it really depends on what you assume your audience knows (and you will need to make assumptions about that). Directed acyclic graphs are a basic computer science topic. There is no way around it. DAGs are introduced in intro to algorithms and data structures courses, right on the first semester of any first year course. Arrays, linked lists, trees, graphs. Far from obscure topics. Well, DAGs lie right between trees and graphs, and are typically the very first type of graph presented to freshmen. Also, DAGs pop up all the time in practical applications.
biellls 4y ago
It's commonplace in data engineering circles, so if that's where the author comes from it's understandable that it wouldn't occur to him that it's not the case in every discipline of programming.
dustingetz 4y ago
(speaker here) you’re right, sorry, i actually messed up a slide transition that presents the full form, i will also verbalize the full form in future versions, thank you for the feedback! Are there any other spots that need better explanation?
- pindab0ter 4y ago
  Not that I’ve noticed, thanks for taking it on board!

0xdeadb00f 4y ago

I thought they meant Directed Acyclic Graph [0]. [0]: https://en.wikipedia.org/wiki/Directed_acyclic_graph https://en.wikipedia.org/wiki/Directed_acyclic_graph

unglaublich 4y ago

You have to make some assumptions about what is common knowledge in your target audience. Probably, the author didn't design the title for a general public on HN, but for Getz' fellow software UI researchers. Someone that's not in the target audience will have to do some extra work to get up to speed. Just like an undergraduate will have a hard time understanding a graduate text without a primer.

DerSaidin 4y ago

Should they have defined UI? Should they have defined DB? It is subjective where to draw the line for commonplace, and it depends on the audience. Is DAG a commonplace acronym for people attending HYTRADBOI? Maybe (I see 2 other talks mentioning graphs/trees in their title).

alpaca128 4y ago
It costs nothing to use the full term once or twice. It can prevent confusion, and some people in the audience may not know the concept and googling a few letters is often not the best way to get useful results. Saving a couple syllables in a talk isn't worth it.

arinlen 4y ago

> I’ve never heard of DAG, yet it’s used as if it’s commonplace. DAG, as in direct acyclic graph, is indeed a basic concept of computer science. But indeed the author could do a better job with the text. One of the very basic principles of technical writing is to always introduce the definition when an acronym is first presented, something like "blablabla a direct acyclic graph (DAG)".

mananaysiempre 4y ago
Wouldn’t really call it a “basic principle”: as with anything else, it really depends on what you assume your audience knows (and you will need to make assumptions about that). If you are describing advantages of your new CRDT over past ones, most likely expanding that into “conflict-free replicated data type” will not help any of your readers; if you’ve come to a statistical physics lecture, “BBGKY hierarchy” might be even more evocative than Bogoljubov-Born-Green-Kirkwood-Yvon (seriously, I know the concept but just had to look up one of the surnames). Of course, it’s possible to speak about either of those things without assuming this knowledge, but this is then a very different talk, most of which will be useless to most of the people who do already have it (not all—it’s useful to occasionally read introductory stuff on topics you think you know!). This is essentially the same thing as power-user usability: it can and does evolve into gatekeeping if left unchecked, and a fresh perspective is a useful check, but assuming everyone is a novice is not the right approach either. (Some mathematics books choose the worst of both worlds: you really do need to know X to read this book, but “to make this book self-contained” we just included a short two-chapter summary of X that instills horror in anyone who doesn’t know it and forces everyone who does to dig through every word searching for conventions or non-standard assumptions. I’ve been in both categories, sometimes simultaneously. On the other hand, other introductory sections of this kind are remarkably crisp summaries that I go around recommending to everyone.)
- arinlen 4y ago
  > Wouldn’t really call it a “basic principle”: as with anything else, it really depends on what you assume your audience knows (and you will need to make assumptions about that). Directed acyclic graphs are a basic computer science topic. There is no way around it. DAGs are introduced in intro to algorithms and data structures courses, right on the first semester of any first year course. Arrays, linked lists, trees, graphs. Far from obscure topics. Well, DAGs lie right between trees and graphs, and are typically the very first type of graph presented to freshmen. Also, DAGs pop up all the time in practical applications.

biellls 4y ago

It's commonplace in data engineering circles, so if that's where the author comes from it's understandable that it wouldn't occur to him that it's not the case in every discipline of programming.

dustingetz 4y ago

(speaker here) you’re right, sorry, i actually messed up a slide transition that presents the full form, i will also verbalize the full form in future versions, thank you for the feedback! Are there any other spots that need better explanation?

pindab0ter 4y ago
Not that I’ve noticed, thanks for taking it on board!