Create domain specific glossaries of jargon

know-cujojs / know

Know cujoJS through these short, focused tutorials

Other

5 stars 5 forks source link

Create domain specific glossaries of jargon #6

Open scothis opened 11 years ago

scothis commented 11 years ago

JavaScript and Cujo.js in particular have a lot of jargon that is difficult for beginners to grok.

I propose we create a glossaries directory with domain specific files that contain terms with precise but approachable definitions. Links to a spec can provide the gory details where appropriate.

Off the top of my head, we could have a glossary for each of:

promisses
modules
dependency injection
rest
javascript
...

briancavalier commented 11 years ago

+1 and may want to extend that to cujo-specific terms, like wire's "facets". Even though they are documented in wire's docs, might be nice to include them in the jargon glossary.

unscriptable commented 11 years ago

ooh, good ideas

scothis commented 11 years ago

@briancavalier yea, this is one area where project specific material makes sense. 'scope', 'context', 'component' all overloaded terms that have specific meaning in wire.