docs: fill out changelog a bit

Author: henryiii

README.md

@@ -22,8 +22,8 @@ histogramming, while still providing the power of a full histogram object. See
 [what's new](./docs/CHANGELOG.md).
 
 For end users interested in analysis, see [Hist][], a first-party
-analyst-friendly histogram library that extends boost-histogram with many new
-shortcuts, plotting, and more.
+analyst-friendly histogram library that extends boost-histogram with named
+axes, many new shortcuts including UHI+, plotting shortcuts, and more.
 
 [uhi]: https://uhi.readthedocs.io
 ## Usage
@@ -58,7 +58,7 @@ h2 = hist[::sum, ::bh.rebin(2)]
 
 </details>
 
-We support the [uhi][] [PlottableHistogram][] protocol, so boost-histogram/hist
+We support the [uhi][] [PlottableHistogram][] protocol, so boost-histogram/[Hist][]
 histograms can be plotted via any compatible library, such as [mplhep][].
 
 [uhi]: https://github.com/scikit-hep/uhi
@@ -174,7 +174,7 @@ python3 -m pip install boost-histogram
 
 All the normal best-practices for Python apply; Pip should not be very old (Pip
 9 is very old), you should be in a virtual environment, etc. Python 3.6+ is
-required; for older versions of Python, version `0.13` will be installed
+required; for older versions of Python (3.5 and 2.7), `0.13` will be installed
 instead, which is API equivalent to 1.0, but will not be gaining new features.
 
 #### Binaries available:

docs/CHANGELOG.md

@@ -3,25 +3,36 @@
 ## Version 1.0
 
 Dropped support for Python 2 and 3.5; removed large numbers of workarounds.
-Subclassing histogram components now uses Python 3 class keyword syntax to set
-families. Fully statically typed.
+Fully statically typed. API compatible with the final `0.x` release for most
+uses, except for subclassing; subclassing histogram components now uses Python
+3 class keyword syntax to set families.
 
 #### User changes
 
 * Dropped Python 2.7 and 3.5 support [#512][]
 * Removed deprecated `.options` from axes. Use `.traits` instead. [#503][]
+* Full static typing available, UHI 0.1.2+ supported. [#516][], [#517][], [519][], [#520][], [#521][], [#523][]
+
+#### Subclassing Histogram changes
+
 * Use keyword class family setting when subclassing histogram components
   instead of custom decorator. [#513][]
-* Full static typing available. [#520][]
+* Structure of internal repr creation changed and made slightly more public. [#518][]
 
 #### Bug fixes
 * Consistently show `metadata=` in repr if present; refactored internal repr handling [#518][]
+* Minor typing related fixes for rare bugs (especially in `numpy.py`, [#521][])
 
 [#503]: https://github.com/scikit-hep/boost-histogram/pull/503
 [#512]: https://github.com/scikit-hep/boost-histogram/pull/512
 [#513]: https://github.com/scikit-hep/boost-histogram/pull/513
+[#516]: https://github.com/scikit-hep/boost-histogram/pull/516
+[#517]: https://github.com/scikit-hep/boost-histogram/pull/517
 [#518]: https://github.com/scikit-hep/boost-histogram/pull/518
-[#518]: https://github.com/scikit-hep/boost-histogram/pull/520
+[#519]: https://github.com/scikit-hep/boost-histogram/pull/519
+[#520]: https://github.com/scikit-hep/boost-histogram/pull/520
+[#521]: https://github.com/scikit-hep/boost-histogram/pull/521
+[#523]: https://github.com/scikit-hep/boost-histogram/pull/523
 
 
 ## Version 0.13