Free-programming-books: リストの一貫性(ヘルプ募集)

作成日 2020年10月21日  ·  5コメント  ·  ソース: EbookFoundation/free-programming-books

Hacktoberfestの期間中の追加の洪水で、リンクが一貫して表示されない場所にいくつかのサイト/パブリッシャー/プラットフォームが追加されているのを目にしています。
一例は、goalkickerによる本です。
ゴールキッカーのリストのほとんどは次のようになります。
* [Spring Framework Notes for Professionals](https://books.goalkicker.com/SpringFrameworkBook) - Compiled from StackOverflow documentation
これは、読者に何を期待するかについての考えを与え、適切な帰属を提供します。 ただし、すべてのゴールキッカーリンクが同じようにフォーマットされているわけではありません。

同様に、ウィキブックスのリンクには一貫性がありません。これに対処するためのPRがすでに行われています。 #4230

私たちのコースリストは多くを費やしており、プラットフォームの帰属は一貫していません。 そのはず:
`*リソースによって与えられたタイトル-インストラクター/クリエーター(プラットフォーム)

一貫性を向上させるためのPRは歓迎されます。

PR requested discussion help wanted

全てのコメント5件

@eshellman私もこの矛盾に気づきました。プラットフォームを「YouTube」として言及する必要があるのでしょうか、それとも言及されていない場合は暗示されるのでしょうか。 「HTML」が追加された一部のリンクに似ていますが、他に指定されたHTML(PDF、EPUBなど)であると想定できます。

@SethiPandiどう思いますか?

すべての返信の長さからお気づきかもしれませんが、私は常に冗長性と曖昧性解消のファンでした。

特に、すべてのユーザーが賢明であるという保証がないため、賢明なユーザーが推測する可能性がある場合でも、明示することは常に良いことだと思います。

私の意見では、間違いなく推測できるのはHTMLだけですが、それでも、必須である必要はありませんが、HTMLを指定するのが理想的だと思います。 ただし、YouTubeがどこで推測できるかはわかりません。

_以下は私の個人的な経験のみを表しており、平均的なユーザーではありません。_
私はこれを、私が実際にはほとんどがPDFではないことに気付くまで、すべての本がPDFであることを個人的に期待していた人として言います。 (私はKOReaderでオフラインで読むことを好みます。)
もちろん、私はこれを_今_知っていますが、リポジトリに不慣れで、慣習に精通していない人としては知りません。

「YouTube」と「Github」をリストから削除できます。コースの場合、プラットフォームはより多様なエクスペリエンスを提供し、登録要件がある可能性があるため、プラットフォーム名の方が便利です。

「HTML」は、それが利用可能な唯一の形式である場合にのみ示されるべきです-多くの場合、私たちのリンクは、複数のタイプのコンテンツへのリンクを提供するWebページにつながります。

@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

PRから:
MIT OpenCourseWare#5087
ウィキブックス#4230
udacity#3880
リーンパブ

このページは役に立ちましたか?
0 / 5 - 0 評価