9 ms·
Building a self-updating profile README for GitHub
- djrobstep 6y agoAnybody know how you create one of these profiles if you already have a private repo with the same name as your username?
- StavrosK 6y agoPut the README in it?
- RaycatRakittra 6y agoPretty sure it has to be a public repo with a README.md in it
- suyash 6y agoThe secret trick is to create a new public repository and name it your 'username'. That should do it. Also nice to see this new hack using GitHub actions to keep the current updated. Here is my profile README (kept it simple), love to see others as well: https://github.com/suyashjoshi https://github.com/suyashjoshi
- rejschaap 6y agoAssuming you don't want to make the current repo public, you have to rename the current repo and create a new public repo with your username. Obviously that will break redirects, so update your existing references to that repo.
- techntoke 6y agoWhy GitHub and not GitLab or Gitea.
- abathur 6y agoBecause GH just released a feature that shows github.com/username/username/readme.md on your profile page.
- techntoke 6y agoSo now we're building tools to simply update a single markdown file exclusively for GitHub profile pages? You know what would be really awesome? Providing a link to your website where you self-host a decentralized SCM platform.
- gary-kim 6y agoI'm a Gitea maintainer and I still do most things on GitHub rather than my self-hosted Gitea instance because a lot of open source projects as well as the people willing to help with them are there. Overall, your project tends to get more attention and contributions if it's on GitHub. Now, we can discuss about whether or not that's a good thing and the quality of the kind of contributions you tend to get because of the lower barrier but GitHub, at least currently, still has a place in the workflow of a lot of people. What you propose would also be really awesome. A feature like this in Gitea could be really nice. If you'd like, you can open an issue on the Gitea issue tracker [1] for the feature. [1] https://github.com/go-gitea/gitea/issues/new/choose https://github.com/go-gitea/gitea/issues/new/choose
- rapnie 6y agoI use Gitea and I love it. The network effects and reach of GH are holding people back from discovering / using / contributing to other forges (gitlab, gitea, sourcehut) that are spread over numerous instances. Even just giving a star to show your appreciation for a project or a comment on the issue tracker often requires you to create a new account just for that. Microsoft with features like these, acquiring NPM etc. and more to come, will be 'the Google of the dev world' (or they already are). Locked-in by the platform and by FOMO we'll be. And Gitea and other such fine works only used in the fringes of software development is my fear. Big tech is causing big problems, as often discussed on HN. In this domain there are still competitors that can pick up the glove and put up a real fight. Gitlab can, but Gitea could do too. And imho here's how: Federated forges, by adopting ActivityPub-based ForgeFed protocol [0]. I've searched your issue tracker and see [1] you are already considering adoption of parts of it. I think federation support will greatly boost the attractiveness of Gitea as an alternative to GH. PS. I've also heard talk to create federated LinkedIn alternatives. [0] https://forgefed.peers.community https://forgefed.peers.community [1] https://github.com/go-gitea/gitea/issues/9045 https://github.com/go-gitea/gitea/issues/9045
- 65536 6y agoLooks neat on Desktop version of GitHub. Looks less neat on mobile version of GitHub. Still cool though.
- sradman 6y agoSimon chose to mimic a two-column layout using a table. I’m not sure if a overflow-x style [1] would work on GitHub or improve the responsive design. [1] https://www.w3schools.com/howto/howto_css_table_responsive.asp https://www.w3schools.com/howto/howto_css_table_responsive.a...
- simonw 6y agoUnfortunately GitHub flavored markdown really limits your options for styling - it doesn't allow CSS at all. https://twitter.com/simonw/status/1281450155170922496 https://twitter.com/simonw/status/1281450155170922496
- sradman 6y agoThe style="overflow-x:auto;" seems to be the default now. "Ask and thou shall receive"? I'm pretty sure it wasn't scrolling when I first tried it but I may have just started searching first out of curiosity. Several posts indicated that inline CSS was possible on GitHub. I did a quick test and I can't get the original overflow-x:visible; behavior so who knows.
- rvz 6y agoTranslation to recruiters: "Building a LinkedIn-like Developer profile on GitHub" Next stop for Microsoft: Add your real LinkedIn profile. What could possibly go wrong?
- bobblywobbles 6y agoSo, where's the distinction going to be? Use Github for developer networking, LinkedIn for non-developers?
- waheoo 6y agoYou know a lot of developers arent on linkedin right?
- craz8 6y agoYou know a lot of developers don’t have public github profiles right? Neither of these places will find you every possible developer
- rapnie 6y agoBut there will be pressure to have one, once GH becomes the place for IT companies to recruit. There'll be FOMO and less people have their projects/contribs in other forges.
- mvanbaak 6y agoAnd like that it turns into another linkedin, and everybody will go somewhere less bloated
- waheoo 6y agoThats my point.. Maybe its not a problem for microsoft to be using the multiple channels available to them to diversify and extend their reach.
- 6y ago
- blondin 6y agohey github desktop team if you are reading this post... a feature i love about github desktop is auto-generated commit messages. some commit messages are not worth spending time on. and yet people insist on us wasting time writing them. github desktop makes me extremely happy with these "boring" but so useful messages. auto-generated commit messages are the best things any git client has ever done! hoping that the team will continue to work on that feature. in fact, i would love to not have have to write a single commit message except for merges, amending, and pull requests.
- benatkin 6y agoAnother option is to include a dynamically generated svg image. Usually these are used for tiny badges, but they can be used for displaying data as well. There's an app called feathub that does it. Here it is in action: https://github.com/agershun/alasql#miss-a-feature https://github.com/agershun/alasql#miss-a-feature
- icey 6y agoheh, I just knocked together a little viewcounter / webring thing that does this exactly this. I haven't spent much time with SVG in the past, but it was really easy to do. (This was an excuse for me to play with both SVGs and Nim). It's just XML so it's really simple (here's the webring thing, if you want to see for yourself: https://github.com/pmn/randos.online https://github.com/pmn/randos.online)
- tompic823 6y agoThis post taught me about two GitHub Actions features I've been wanting and didn't know existed: 1. You can schedule workflows. This is super useful for running dependency vulnerability scanners on repos that don't see active development. 2. You can manually trigger workflows. This is perfect for one repo I have where I manually build releases. The branching model doesn't lend itself well to a PR release action, and the need for inputs complicates things further. But now I can move the release infrastructure off of my laptop and into GitHub Actions.
- simonw 6y agoSince I wrote this I've seen a bunch of cool automated profile READMEs show up. Two of my favourites: Zhi Yang built one which fetched their latest tweet, renders it to a PNG using headless Chrome (from an R script) and adds it to her profile: https://github.com/zhiiiyang https://github.com/zhiiiyang Katie McLaughlin built one that does an ASCII art render of her profile: https://github.com/glasnt https://github.com/glasnt I'm collecting these in a Twitter thread as I spot them: https://twitter.com/simonw/status/1281435464474324993 https://twitter.com/simonw/status/1281435464474324993
- hlhielkema 6y agoThank you for your awesome blog post. You also inspired me to make something fun: https://github.com/hlhielkema/cat_facts_readme https://github.com/hlhielkema/cat_facts_readme
- ddrt 6y agoHow do you stumble upon all these new applications?
- simonw 6y agoBoth of those people tweeted at me about them.
- tholford 6y agoNice work, Simon. Started collecting some of those examples here: https://github.com/tomholford/awesome-profile-readmes https://github.com/tomholford/awesome-profile-readmes
- rat323 6y agoIt looks to me you're trying to shove a diversity agenda by linking female profiles only.
- rat323 6y agoIt looks to me you're trying to shove a diversity agenda by linking female profiles only.
- instance 6y agoThis is awesome. I just made one for my account, with a picture on the left and some notes about myself on the right. If anyone's interested, you simply use align="left". https://github.com/instance01 https://github.com/instance01 Edit: Include the image with html in Markdown, so <img src="..." align="left">.
- pieteradejong 6y agoThanks! I've borrowed this one, with very basic info.
- doersino 6y agoYou should probably credit the artist: https://twitter.com/bysau_/status/1281590003701813254 https://twitter.com/bysau_/status/1281590003701813254
- instance 6y agoThanks, added a link.
- pgz 6y agoGreat, I already feel inferior. I only put an ASCII cat on my profile.
- metalliqaz 6y agoDon't feel that way. I initially had to jump on the bandwagon and have a nice, link-filled README on my profile, but I ended up removing it all. The profile page is already good. It has your avatar, a short description from your profile, your group memberships, a list of your repos, and a good graphical representation of your work on Github. It is a github profile, after all. A personal webpage is better for all the other information about you, and you can just put that link in your profile description.
- fedleiv 6y agoIt's a new addition, so I'm giving it time to see how it's going to be used in the wild and although I kinda like OP's take, the ones with giant images, GIFs, too much text... I'm not so sure. Maybe it's just like this now because it's a shiny new toy and people are pushing its boundaries but will die down later. I'm lightly skewing towards just hiding it with a custom rule and forget about them. I visit a Github profile to quickly see what the developer codes instead of a showcase of their personality which, as you said, would be better served by a personal website.
- k__ 6y agoGAMD is the new stack? ;)
- hivacruz 6y agoI just put a single gif (a "cinemagraph" to be exact) in my profile for now: https://github.com/kinoute https://github.com/kinoute I'm already amazed by the different profiles I've seen so far.
- yasinaydin 6y agoYour website with the same gif seems blanking out on each cycle: https://y.defret.in/ https://y.defret.in/
- tenryuu 6y agoQuite a big file for basic vanity...