Documentation contribution page improvements

Fix a few glitches and add a troubleshooting section.