Release train for 1.0

- [x] README cleanup/update regarding maintenance
- [x] README regarding “alpha” state
- [x] offset documentation
- [ ] javadoc cleanup sweep
- [ ] dead code sweep
- [ ] todo sweep
- [ ] disabled test sweep
- [ ] potentially remove streaming interfaces

Issues targeted for 0.5:
----

In priority order - only items marked *high* will block the 1.0 release.

Tech debt / refactoring:
- [x] #223
- [x] #224
- [x] #218
- [x] #219

Tech debt:
- [x] #201
- [x] #236
- [x] #229
- [x] #197
- [x] #215

Enhancements High:
- [x] #216

Features High:
- [x] #18

Features Low:

Issues targeted for NEXT:
----

Fixes:
- [x] #205
- [x] #203
- [x] #184
- [x] #195
- [x] #318

Tech debt:
- [ ] #271
- [x] #289
- [ ] #270
- [ ] #220
- [ ] #192
- [ ] #290

Enhancements High:
- [x] #268
- [x] #242
- [ ] #78
- [x] #65
- [x] #297
- [x] #327

Features High:

Features Low:
- [x] #193
- [x] #110

Issues targeted for NEXT NEXT:
----

Features:
- [x] #175
- [ ] #170
- [ ] #71
- [x] #187
- [x] #183
- [x] #191
- [ ] #186
- [x] #185
- [x] #176
- [ ] #310
- [x] #372

Tech debt:
- [ ] #259
- [x] #247
- [x] #246
- [ ] #81

Issues targeted for post 1.0:
----

Features high:
- [x] #232
- [x] #226
- [x] #225
- [ ] #241

Examples Low:
- [ ] #178
- [ ] #171

Tech debt:
- [ ] #233
- [ ] #103
- [ ] #200
- [x] #144

Features low:
- [ ] #196