bugfixes:
    - improved block docs