added examples and howtos