Free-programming-books: 列表的一致性(需要帮助)

创建于 2020-10-21  ·  5评论  ·  资料来源: EbookFoundation/free-programming-books

在Hacktoberfest期间,随着大量的添加,我看到一些添加了不一致显示链接的站点/发布者/平台。
一个例子是守门员的书。
我们的大多数门将清单如下所示:
* [Spring Framework Notes for Professionals](https://books.goalkicker.com/SpringFrameworkBook) - Compiled from StackOverflow documentation
这使读者对预期的情况有所了解,并提供适当的归因。 但是,并非我们所有的守门员链接的格式都相同。

同样,Wikibooks链接也不一致-已经有PR致力于解决该问题。 #4230

我们的课程清单花了很多钱,并且平台归属也不一致。 它应该是:
资源提供的`*

公关公司提高一致性的做法将受到欢迎。

PR requested discussion help wanted

所有5条评论

@eshellman我也注意到了这种不一致,是否有必要将平台提到为“ YouTube”,或者如果未提及,则暗示它吗? 类似于某些链接上添加了“ HTML”的链接,但可以假定它将是其他指定的HTML(例如PDF,EPUB等)。

@SethiPandi你怎么看?

您可能已经注意到我所有答复的持续时间,但是我一直都是冗长和歧义的拥护者。

我觉得露骨总是很高兴的,即使对于明智的用户可能会推断出的事情,尤其是由于无法保证所有用户都会明智。

在我看来,唯一可以辩解的东西是HTML,但是即使那样,我仍然认为它是理想的,尽管不必强制性地指定它。 不过,我不确定在哪里可以将YouTube视为可推论的。

_以下内容仅代表我的个人经历,而非一般用户。_
我这样说的是我个人期望所有书籍都是PDF,直到我意识到实际上实际上根本不是PDF。 (我更喜欢在KOReader中离线
当然,我现在知道这个,但是不是一个刚接触存储库并且不熟悉约定的人。

我们可以从清单中删除“ YouTube”和“ Github”,对于课程,平台名称更有用,因为平台提供了更多的体验,并且可能有注册要求。

仅当“ HTML”是唯一可用的格式时,才应指出“ HTML”-通常,我们的链接指向一个网页,该网页提供了指向多种类型内容的链接。

@eshellman好的,听起来不错

我们需要编译提供程序特定的一致性说明。 所以...

Please add the "Compiled from StackOverflow documentation" attribution we use for goalkicker books
For youtube, we prefer "playlist" links and the name of the producer/creators

从PRs:
麻省理工学院开放课件#5087
Wikibooks#4230
大胆#3880
leanpub

此页面是否有帮助?
0 / 5 - 0 等级

相关问题

ghost picture ghost  ·  17评论

taiyoslime picture taiyoslime  ·  14评论

sayopaul picture sayopaul  ·  3评论

harrykar picture harrykar  ·  9评论

eshellman picture eshellman  ·  18评论