docs: clarify docs to address installation errors

Created by: fivecar

This addresses one category of issue that things like #12282 talk about. The original docs' instructions don't fix the uncleared-cache problem for people.