Python plugin interface documentation and examples

[fabiansvara]

The plugin interface should be as accessible as possible to users, that means we need good API documentation and well-commented examples. Oren, you can coordinate with Michael and My-Tien - they can write the docs eventually, but need to be briefed...