4 ms·

"Let's begin with an analogy" [4 paragraphs of fantasy explorer game references] All I've learned is my brain hurts.

discordance 9y ago
Terrible doc writing. 'For your territory to be a part of Royaume, the land ordinance requires construction of a building (container), specifically a castle, from which your territory’s lord (agent)* rules.'
- Zaheer 9y ago
  It's a blog post and not docs. I don't think it's unreasonable to spice up blog posts whereas docs should be straight-up.
  - avemg 9y ago
    Of course it's not unreasonable to do that. The problem is that the analogy was a terrible one.
    - tiffanyfj 9y ago
      Suggestions on how to improve it?
kinkrtyavimoodh 9y ago
Yeah seriously what the hell. And it's not as if the game references are universals. All this obfuscation for an obtuse and needless analogy.
- linkmotif 9y ago
  This is like the whole GraphQL Star Wars schtick. I really don’t enjoy Star Wars, so reading their documentation was a total drag.
  - RexM 9y ago
    There are dozens of us!
    - linkmotif 9y ago
      So good to know. <3
  - icebraining 9y ago
    GraphQL just uses it as placeholder data, no? I don't think you have to know or understand anything about SW to read the docs.
- DonHopkins 9y ago
  Cringing in anticipation of the freemium / in app purchase analogy.
paulddraper 9y ago
If you insist on analogies, just say "ECS is like a burrito" and get it over with.
danial 9y ago
The author is trying to have some fun. Perhaps she’s trying to empathize with a beginner getting their head around what ECS is. We all have different perspectives because the lenses with which we see the world are different. It’s possible you didn’t enjoy it because you’re not avid fantasy explorer gamer. Maybe you didn’t need an introduction to what ECS is.
- wutbrodo 9y ago
  > Perhaps she’s trying to empathize with a beginner getting their head around what ECS is. I think the complaint was that it made it _harder_ to understand. Analogies are helpful if the relationships they describe are already well-known, but just dropping _Royaume_ into a sentence is dumb and hurts readability (instead of, e.g., sticking with "kingdom", from the analogy).
  - tiffanyfj 9y ago
    Suggestions on how to improve it? Whether it's kingdom or not, it's just a cluster name which can be anything.
yeukhon 9y ago
I think a video could have been a better choice...
_zachs 9y ago
I know right? I can't believe this article was approved with that analogy.
- tiffanyfj 9y ago
  Suggestions on how to improve it?

Terrible doc writing. 'For your territory to be a part of Royaume, the land ordinance requires construction of a building (container), specifically a castle, from which your territory’s lord (agent)* rules.'

Zaheer 9y ago
It's a blog post and not docs. I don't think it's unreasonable to spice up blog posts whereas docs should be straight-up.
- avemg 9y ago
  Of course it's not unreasonable to do that. The problem is that the analogy was a terrible one.
  - tiffanyfj 9y ago
    Suggestions on how to improve it?

kinkrtyavimoodh 9y ago

Yeah seriously what the hell. And it's not as if the game references are universals. All this obfuscation for an obtuse and needless analogy.

linkmotif 9y ago
This is like the whole GraphQL Star Wars schtick. I really don’t enjoy Star Wars, so reading their documentation was a total drag.
- RexM 9y ago
  There are dozens of us!
  - linkmotif 9y ago
    So good to know. <3
- icebraining 9y ago
  GraphQL just uses it as placeholder data, no? I don't think you have to know or understand anything about SW to read the docs.
DonHopkins 9y ago
Cringing in anticipation of the freemium / in app purchase analogy.

paulddraper 9y ago

If you insist on analogies, just say "ECS is like a burrito" and get it over with.

danial 9y ago

The author is trying to have some fun. Perhaps she’s trying to empathize with a beginner getting their head around what ECS is. We all have different perspectives because the lenses with which we see the world are different. It’s possible you didn’t enjoy it because you’re not avid fantasy explorer gamer. Maybe you didn’t need an introduction to what ECS is.

wutbrodo 9y ago
> Perhaps she’s trying to empathize with a beginner getting their head around what ECS is. I think the complaint was that it made it _harder_ to understand. Analogies are helpful if the relationships they describe are already well-known, but just dropping _Royaume_ into a sentence is dumb and hurts readability (instead of, e.g., sticking with "kingdom", from the analogy).
- tiffanyfj 9y ago
  Suggestions on how to improve it? Whether it's kingdom or not, it's just a cluster name which can be anything.

yeukhon 9y ago

I think a video could have been a better choice...

_zachs 9y ago

I know right? I can't believe this article was approved with that analogy.

tiffanyfj 9y ago
Suggestions on how to improve it?