Working on some release with new sample Bugs #wip

Working on new feature containing some nicely crafted bugs:

- [x] First a nice doc
- [x] then add some testcases
- [x] add actual bugs
- [x] finalize it by actually make more doc