Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

The marketing text in the readme is more self congratulatory than useful to the end user. It’s fine to be proud of one’s work, but the documentation should first consider the needs of the project’s consumers. If it were up to me I’d strip out all the nonsense about the beauty of the code—at the end of the day, it needs to run well. Whatever clever or minimal techniques or linter rules you think make the code beautiful are not relevant to anyone that’s not a contributor to the code base.


Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: