Check out the rust libz blitz, a documentatuon overhaul initiaitive by the rust devs. It addresses all of these issues.