All my repos that have a bad or unclear description have few watchers. Why? Because many of them are not found through google, but from people that watch one of my plugins and have a look at the rest. Any repository that does not clearly state its use, within the 3 seconds of read it gets, is not looked at further.
- Which architecture does it use ? – prefix with e.g. Rails: AR: jQuery:
- What does it do? – clear, short explanation
Bad — When Active Record objects are saved from a form, empty fields are saved as empty strings instead of nil. This kills most validations.
Good — AR: store empty strings as NULL, making queries + conditions simpler and code more robust
And now ill continue renaming… 😉