Along with Images

[tekjar]

Let's try to include lot of images with USER documentation.

for example in --> https://github.com/Grayda/sphere-documentation/wiki/LED-Images-and-their-meaning
Is it possible to include images in .md files ?

[theshaun]

Certainly, the markdown documentation explains it here

Simply provide the image with alternative text like this

![cat](https://media3.giphy.com/media/tuvMgAPzxaQBq/200_s.gif)

[Grayda]

Also, if we're going to include screenshots, we should also note down any relevant text that people might want to copy (e.g. if we're showing a command to type in, or something people might want to search on Google, include the text as a caption). I've read far too many tutorials that have great content, but the stuff you want to Google to research, is in a tiny screenshot

Also, some of the LED matrix icons can be extracted from GitHub or the Sphere itself (in the sphere-led-controller repo, I think). They're 16x16, but blown up, they look sort of like what you'd see on top of the Sphere

[paulcull]

would be helpfull to get a library of 16x16 images

[Grayda]

The images are stored here. To get them to display nicely they need to be resized without whatever editing program blurring them.

EDIT: And just for anyone reading, icons can be loaded from /data/icons. This is more for anyone tinkering with the source and adding their own icons to apps. But still good to know.

[theshaun]

http://ezgif.com/resize lets you resize them without loosing 'quality'

They kinda look pretty cool

[Grayda]

I just tried a few and they do look pretty good. The Gifsicle setting works best for sharper edges than Imagemagick which seems to blend the edges for a smoother look

EDIT: I've added some basic instructions to the wiki for adding LED matrix gifs