repo notes & extended readmes