doc: adds troubleshooting tips that may be useful
doc: adds todo