[docs] examples polished

• unused examples removed
• examples that are described in vignettes removed
• built vignettes saved under inst/vignettes_built
• additional bugfixes

Closes #46 (closed) Closes #49 (closed) Closes #48 (closed) Closes #50 (closed)