split notes and readme, improve lint tool a bit