TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

How to make a good-looking README for a GitHub repo?

15 点作者 yegor256a大约 6 年前

4 条评论

jitl大约 6 年前
The advice about badges reads like parody to me. I only really care if the project has CI. The Zoid repo has way too many!<p>I focus on making sure the mobile view of the github page has a compelling summary of the state of the project “above the fold”:<p>- purpose and goal<p>- programming language<p>- software type: library, framework, language, CLI, server, etc<p>- maturity: age, production-readiness, prominent users, corporate backing<p>Logo is a nice-to-have.
评论 #19731166 未加载
wutwut5521大约 6 年前
Wow, the first readme linked is horribly ugly and provides no context above the fold. It looks like the zodiac killer’s rear bumper.<p><a href="https:&#x2F;&#x2F;github.com&#x2F;zold-io&#x2F;zold" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;zold-io&#x2F;zold</a>
earenndil大约 6 年前
&gt; Changelog [...] is something from Pre-GitHub time. I would recommend you rely on the &quot;releases&quot; tab<p>&gt; GitHub has a special tab in each repository, which is called “contributors.” There is absolutely no reason to reproduce the list in the README file.<p>Why would you tie yourself to github like that?
uira大约 6 年前
We super need these kind of content, in Portuguese