Quote:
Originally Posted by lordeagle
I get the idea, and understand that the involved devs don't want to be flooded with too much noise around well known early prototype shortcomings.
However, it's also a missed chance to get early feedback around the most wished features/bugs from a larger user base.
|
It is indeed a double-edged sword

.
Quote:
Originally Posted by lordeagle
I think, that it would have helped a little to have a shorter readme with fewer words, but the most recommended build/release commands at top. Including the commands to use koxtoolchain. ... and then following with the details later what it does and why we do it that way. Just give the user first what he needs want's to know first ... there has been a lot of smart good guidance on this in here: https://www.americanscientist.org/bl...ntific-writing
I'll try to fire a simple PR if I can make this more concrete.
|
Yep, writing good doc is hard

.