edit doc + adding examples files (not working properly) for Shapes decorator