GitHub Readme Templates
github.com
github.com
The ones I saw all shared the sensibility of something written in Comic Sans MS using the <blink> tag.
Apparently HN doesn't let you publish emoji? I thought we had UTF-8.
But I wouldn't go so far as to say it's "not worth our note". The project does have merit as a collection of READMEs - I did get some ideas for my own. It's just not curated enough (or at all), to filter out one-off creations and select what's actually useful as a template.
I don't necessarily agree, as what is needed most right now is inertia and having this turn into a dumping ground, serves quite a bit of value...for now anyways. It's much easier to curate when everything is in a single location.
What I think they can do a much better job of is classifying the submissions. If you take a look at the files changed heat map/tree below:
the most active categories are "multimedia" (48 versions) and "short-and-sweet" (46 versions), where many in multimedia should be in short-and-sweet. The project can probably benefit from sub folders.
> It's much easier to curate when everything is in a single location.
PR requests are ideal for this.
That's why we have early adopters to bring it to a more universally accepted state :-)
This project is quite interesting from a pure analytics point of view. It's only about 3 weeks old, and it already has 4k stars and its trajectory is quite steep as shown below:
This project also has a healthy number of new pull requests so clearly something is working. What would be interesting, would be to cross reference the rate at which people are "starring" with the growth of the project.
Given the limited data (3 weeks), it would be hard to say if taking a more aggressive curating approach would hurt or help the project.
Who are the early adopters? People that want to have their profile featured, or people hoping to find inspiration?
> This project is quite interesting from a pure analytics point of view
> This project also has a healthy number of new pull requests so clearly something is working
> cross reference the rate at which people are "starring" with the growth of the project.
I don't see how any of these metrics reflect the quality of the service. If it were a resume collector, then I'd be in complete agreement: Things are going fantastically. But the way it's branded, it's supposed to help people find inspiration for their own readmes, and quantity of examples is not a positive factor in that service's quality.
If I were using this to find a template that worked for me, I would want to have to look through a minimum number of submissions to find one, not trudge through endless submissions that have little to no appeal.
Additionally, I'm seeing profiles that are copies of each other in the listings. Perhaps it would be appropriate to remove the "template" from the repo's name, as it isn't providing _templates_, just profiles. If it were, duplicates would not be accepted, and the examples would have sample data (eg "John Doe john@example.com" rather than people's actual info.
This is why it is important to cross reference the stars with the state of the project. What if 90% of the starring occurred within the last week? If this is so, it would indicate many felt this repository provided value based on 2/3 of the repos history.
It is important to note that I am not discrediting your opinion, what I'm trying to say is, the numbers might show many do not share in your opinion. Also, calling this a "service" doesn't make much sense, since I don't think the repo maintainer is being paid to provide a specific value that benefits you.
The README pretty much invites you to submit a template with no real barrier to submission. Your "Awesome" may well be different than many others "Awesome".
I too think that there needs to be a proper filter. Just bear with me for a couple of days, I have already planned to change the format and the current state of the repo, it's just that I am kind of preoccupied with some work. It's also worth noting that people are actually finding some inspiration for their own readme, so I feel it's working out positively for some.
I created this repo for myself and did not expect it to blow up like this. Thanks for the valuable suggestions though, do let me know what else could be done to improve it :D
Hah! In that case, congratulations on the unexpected success. Great initiative and I hope to see this project again in the future.
I don’t really care what people’s social media accounts are. I am interested in what projects they author or contribute to, so for much of the content is way off focus. Maybe it’s just because I’m old.
https://github.com/kautukkundan/Awesome-Profile-README-templ...
https://github.com/kautukkundan/Awesome-Profile-README-templ...
In this case I assume the domain holds some weight?