WIP: 1.2 Upgrade & Support

todo: finish documentation, mainly, and wait until an issue is resolved