update documentation with alternatives and Fabians article