Having diagrams that explain concepts visually is fundamental to good documentation. Unfortunately, most engineers are not designers, which means that most diagrams are more hindrance than help. Here are some examples of bad or mediocre technical diagrams:
Here are some examples of what I consider to be good diagrams:
What I’d like your help with:
Create a design language that fits with the Ember.js website design aesthetic for architectural and other explanatory diagrams. You should use the existing diagrams as a starting place. You can find them in the Ember.js website repository (just clone the repo to your computer and search for all of the images using something like Spotlight).
Once that’s done, we’ll create re-usable components (using something like SVG, perhaps) that contributors to the guides can use to build diagrams that are both consistent and pleasant to the eye.