7 ms·

GitHub Readme Templates

140 points by utsav91292 6y ago

exdsq 6y ago
How do posts reach the top of HN with 6 points and no comments? Confused how the algo works now :)
- deleted 6y ago
  [deleted]
- gregmolnar 6y ago
  The goal is to confuse us, so we can't fool the algo :) In this case I assume the domain holds some weight?
- Xelbair 6y ago
  Can't find the exact guideline - but mods give 'second chance' to some interesting topics on case-by-case basis.
- janober 6y ago
  One important factor is how fast that 6 upvotes happened and from who. If it got posted and got 6 upvotes within a few minutes and that from "proper" accounts it is on the front page. If it has the same amount but it takes 30 min then not. At least from my personal experience.
  - exdsq 6y ago
    This was at 19 minutes
angyrold 6y ago
These templates (especially dynamic realtime) give me a 1990s Geocities vibe. Cool
- detaro 6y ago
  I find these interesting. One the one hand, cool, on the other: you could have had any of this, with even more flexibility, on a personal homepage at any time. What about it being the GH profile triggers this?
Noumenon72 6y ago
I think the title should be "GitHub Profile Readme Templates". I was confused why every one was a person's resume instead of what I was expecting, a template for documenting a project. The ones I saw all shared the sensibility of something written in Comic Sans MS using the <blink> tag.
- edflsafoiewq 6y ago
  Emojis are the new <blink>.
  - jhardy54 6y ago
    <blink>️️U+1F440</blink> Apparently HN doesn't let you publish emoji? I thought we had UTF-8.
    - jwilk 6y ago
      HN purposefully removes emoji: https://news.ycombinator.com/item?id=20776571 https://news.ycombinator.com/item?id=20776571
  - gruez 6y ago
    It’s actually worse because at least blink tags are confined to browsers. Now you have developers putting emojis in log statements for whatever reason.
    - laumars 6y ago
      You could probably do the same with the blink ANSI escape sequence if your logs are getting displayed in the terminal. Though I’d recommend you not to use that particular escape sequence...ever.
deleted 6y ago
[deleted]
trzeci 6y ago
I can't read half of them, maybe if someone would add more emoji would be easier.
smlckz 6y ago
A slightly off-topic question: what is the name of the font used in that picture, of the text 'Awesome Profiles'?
- kkautuk 6y ago
  it's "product sans"
hobo_mark 6y ago
Awesome, I'm so thrilled about the myspaceification of GitHub profiles, pairs great with the new Artic Code Vault Contributor badges. /s
- higeorge13 6y ago
  Let's see what new social-media non-code related functionality will be added next. Location, checkin and filtered photo of each commit, messenger?
  - rathel 6y ago
    Stories! :^)
ionforce 6y ago
This is the new MySpace.
lxtx 6y ago
What's with the proliferation of emojispeak?
- gruez 6y ago
  We’re regressing back to hieroglyphs
austincheney 6y ago
The strangest commonality I noticed is that many of those templates stress social media involvement and not code repositories. The more visually elaborate a template becomes the more true this pattern appears. 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.
- leetrout 6y ago
  It's reinforcing the popularity contests everyone on the net has turned in to in the past 20 years. I miss the old internet and IRC without profiles and "karma".
just-ok 6y ago
Wow, I should find a job I’d be happy staying at for a few decades so that I don’t have to deal with this nonsense come hiring time. Is this really what we want recruiting to become?
simonw 6y ago
I really like profile READMEs that are powered by GitHub Actions (see https://simonwillison.net/2020/Jul/10/self-updating-profile-readme/ https://simonwillison.net/2020/Jul/10/self-updating-profile-... ) - this collection doesn't seem to have a way of sharing those yet, which would be great since getting the Actions YAML right can be tricky to figure out at first.
ysavir 6y ago
The integrity of this being a project to "collect awesome readmes" is somewhat undone by people adding their own readme. It's made worse as it seems each submission is accepted as long as it meets formatting criteria, without any standard for quality. I could see this being a great resource if it were actually a collection of readmes for various projects (and sure, profiles as well) deemed excellent and worth sharing by a single, objective person or group. But as it is, this project is not worth our note.
- sdesol 6y ago
  > But as it is, this project is not worth our note. 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: https://imgur.com/WtzjiET https://imgur.com/WtzjiET 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.
  - ysavir 6y ago
    So another words, if the projects progresses (far) beyond it's current state, it will be worth of note. I agree! But I disagree that accepting everything is the best path to get there. As it is, it's burned away any interest I have in following this repo and checking in for inspiration when needed. > It's much easier to curate when everything is in a single location. PR requests are ideal for this.
    - sdesol 6y ago
      > As it is, it's burned away any interest I have 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: https://imgur.com/Mwz7do2 https://imgur.com/Mwz7do2 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.
tzury 6y ago
I prefer my Readmes minimal and text based. In my world, emojies and animations are not welcomed everywhere. https://github.com/kautukkundan/Awesome-Profile-README-templates/blob/master/code-styled/Thaiane.md https://github.com/kautukkundan/Awesome-Profile-README-templ... https://github.com/kautukkundan/Awesome-Profile-README-templates/blob/master/dynamic-realtime/8bithemant.md https://github.com/kautukkundan/Awesome-Profile-README-templ...

140 points by utsav91292 6y ago

exdsq 6y ago

How do posts reach the top of HN with 6 points and no comments? Confused how the algo works now :)

deleted 6y ago
[deleted]
gregmolnar 6y ago
The goal is to confuse us, so we can't fool the algo :) In this case I assume the domain holds some weight?
Xelbair 6y ago
Can't find the exact guideline - but mods give 'second chance' to some interesting topics on case-by-case basis.
janober 6y ago
One important factor is how fast that 6 upvotes happened and from who. If it got posted and got 6 upvotes within a few minutes and that from "proper" accounts it is on the front page. If it has the same amount but it takes 30 min then not. At least from my personal experience.
- exdsq 6y ago
  This was at 19 minutes

angyrold 6y ago

These templates (especially dynamic realtime) give me a 1990s Geocities vibe. Cool

detaro 6y ago
I find these interesting. One the one hand, cool, on the other: you could have had any of this, with even more flexibility, on a personal homepage at any time. What about it being the GH profile triggers this?

Noumenon72 6y ago

I think the title should be "GitHub Profile Readme Templates". I was confused why every one was a person's resume instead of what I was expecting, a template for documenting a project. The ones I saw all shared the sensibility of something written in Comic Sans MS using the <blink> tag.

edflsafoiewq 6y ago
Emojis are the new <blink>.
- jhardy54 6y ago
  <blink>️️U+1F440</blink> Apparently HN doesn't let you publish emoji? I thought we had UTF-8.
  - jwilk 6y ago
    HN purposefully removes emoji: https://news.ycombinator.com/item?id=20776571 https://news.ycombinator.com/item?id=20776571
- gruez 6y ago
  It’s actually worse because at least blink tags are confined to browsers. Now you have developers putting emojis in log statements for whatever reason.
  - laumars 6y ago
    You could probably do the same with the blink ANSI escape sequence if your logs are getting displayed in the terminal. Though I’d recommend you not to use that particular escape sequence...ever.

deleted 6y ago

[deleted]

trzeci 6y ago

I can't read half of them, maybe if someone would add more emoji would be easier.

smlckz 6y ago

A slightly off-topic question: what is the name of the font used in that picture, of the text 'Awesome Profiles'?

kkautuk 6y ago
it's "product sans"

hobo_mark 6y ago

Awesome, I'm so thrilled about the myspaceification of GitHub profiles, pairs great with the new Artic Code Vault Contributor badges. /s

higeorge13 6y ago
Let's see what new social-media non-code related functionality will be added next. Location, checkin and filtered photo of each commit, messenger?
- rathel 6y ago
  Stories! :^)

ionforce 6y ago

This is the new MySpace.

lxtx 6y ago

What's with the proliferation of emojispeak?

gruez 6y ago
We’re regressing back to hieroglyphs

austincheney 6y ago

The strangest commonality I noticed is that many of those templates stress social media involvement and not code repositories. The more visually elaborate a template becomes the more true this pattern appears. 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.

leetrout 6y ago
It's reinforcing the popularity contests everyone on the net has turned in to in the past 20 years. I miss the old internet and IRC without profiles and "karma".

just-ok 6y ago

Wow, I should find a job I’d be happy staying at for a few decades so that I don’t have to deal with this nonsense come hiring time. Is this really what we want recruiting to become?

simonw 6y ago

I really like profile READMEs that are powered by GitHub Actions (see https://simonwillison.net/2020/Jul/10/self-updating-profile-readme/ https://simonwillison.net/2020/Jul/10/self-updating-profile-... ) - this collection doesn't seem to have a way of sharing those yet, which would be great since getting the Actions YAML right can be tricky to figure out at first.

ysavir 6y ago

The integrity of this being a project to "collect awesome readmes" is somewhat undone by people adding their own readme. It's made worse as it seems each submission is accepted as long as it meets formatting criteria, without any standard for quality. I could see this being a great resource if it were actually a collection of readmes for various projects (and sure, profiles as well) deemed excellent and worth sharing by a single, objective person or group. But as it is, this project is not worth our note.

sdesol 6y ago
> But as it is, this project is not worth our note. 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: https://imgur.com/WtzjiET https://imgur.com/WtzjiET 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.
- ysavir 6y ago
  So another words, if the projects progresses (far) beyond it's current state, it will be worth of note. I agree! But I disagree that accepting everything is the best path to get there. As it is, it's burned away any interest I have in following this repo and checking in for inspiration when needed. > It's much easier to curate when everything is in a single location. PR requests are ideal for this.
  - sdesol 6y ago
    > As it is, it's burned away any interest I have 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: https://imgur.com/Mwz7do2 https://imgur.com/Mwz7do2 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.

tzury 6y ago

I prefer my Readmes minimal and text based. In my world, emojies and animations are not welcomed everywhere. https://github.com/kautukkundan/Awesome-Profile-README-templates/blob/master/code-styled/Thaiane.md https://github.com/kautukkundan/Awesome-Profile-README-templ... https://github.com/kautukkundan/Awesome-Profile-README-templates/blob/master/dynamic-realtime/8bithemant.md https://github.com/kautukkundan/Awesome-Profile-README-templ...