Go through README and verify all information is correct

[MilanStaffehl]

Things to fix:

• [x] In the note about deprecated scalar generics, stress that problems in pydantic validation only arise when pydantic must instantiate an array using a generic scalar as dtype, and that using generics in type checking is very much recommended, as this is specifically what these generics are made for.