poor rules documentation?

[beavis]

various incorrect civilopedia and manual entries really bother me. amongst other errors, the civilopedia states wine gives a universal +1+0+1 bonus, while in my experience its only +0+0+1 in grasslands; mines are noted as giving +2 shields in hills while its really only +1. is this documented anywhere?

[Xentropy]

Err, I haven't noticed the wines problem, but I know for certain that mines on hills *do* give +2 to shield production. Are you a despot? Despotism gives anything 3 or higher a -1, so mined hills under despotism would give only 2 shields instead of 3.

Look before you leap.