added some issues descriptions + workarounds