userguide: breaking up text sections with pictures and code snippets

[IAlibay]

cc @hannahbaumann

Some of our userguide sections are currently quite wordy, we should consider adding more code snippets & images.