These are all fantastic suggestions, but I have one more: do a 15 minute user study.
Find someone who might be interested in the project and offer to screenshare with them as they navigate the README and try to get things set up. Note: you just watch them go through this while they describe their thinking and take notes.
I've done similar things and it never ceases to surprise me the how big the gaps are in my view of the project vs someone fresh to it.
Comments
These are all fantastic suggestions, but I have one more: do a 15 minute user study.
Find someone who might be interested in the project and offer to screenshare with them as they navigate the README and try to get things set up. Note: you just watch them go through this while they describe their thinking and take notes.
I've done similar things and it never ceases to surprise me the how big the gaps are in my view of the project vs someone fresh to it.