Skip to content

Instantly share code, notes, and snippets.

@steveklabnik

steveklabnik/plain_language.txt

Created March 9, 2012 01:54
Show Gist options
  • Save steveklabnik/2004584 to your computer and use it in GitHub Desktop.
Save steveklabnik/2004584 to your computer and use it in GitHub Desktop.
Download ZIP
Hypermedia benefits in plain language
Raw
plain_language.txt
Hypermedia designs scale better, are more easily changed and promote decoupling
and encapsulation, with all the benefits those things bring. On the downside,
it is not necessarily the most latency-tolerant design, and caches can get stale
if you're not careful. It may not be as efficient on an individual request level
as other designs.
@telemachus
Copy link

Hypermedia designs promote scalability, allow resilience towards future changes, and promotes (should be 'promote')

"Hypermedia designs scale better, are more easily changed and promote..."

You may not love my exact wording (I'm not crazy about the "are more easily changed"), but I'm not crazy about "allow resilience towards". I want more verbs and less nouns. :)

@steveklabnik
Copy link
Author

@telemachus yeah, I agree it's awkward. I think I like your wording. More revisions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment