preparing for 0.12

- doc fixes
- refactored registry