Update SharedPreferences documentation with behavior info

Add information about tradeoffs made by SharedPreferences that reflect
changes eagerly before persistence has completed and recommendations
for other options if these tradeoffs are undesirable.

Change-Id: Ie88ef66b244ec3b89f6ad193508c593f422f480f