Free-programming-books: Kriterien für "in Bearbeitung" Bücher

Erstellt am 17. Mai 2017  ·  9Kommentare  ·  Quelle: EbookFoundation/free-programming-books

zunehmend gibt es Vorschläge, dieser Liste unfertige oder "in Bearbeitung" befindliche Bücher hinzuzufügen, zum Beispiel Nr. 2252

Welche Kriterien sollten für das Hinzufügen dieser Art von Buch verwendet werden?

PR requested discussion

Hilfreichster Kommentar

Wie wäre es mit der Auflistung von in Bearbeitung befindlichen Büchern wie diesen:

Am Ende einer Themenliste (ich denke, der Linter wird Emojis alphabetisch an letzter Stelle setzen, außer bei obskuren Zeichen).

Und fügen Sie eine Anleitung hinzu, dass unvollständige Bücher, die seit einem Jahr nicht weitergekommen sind, entfernt werden sollten.

Alle 9 Kommentare

Vielleicht mit einem Label nach dem Link in der Liste hinzufügen? Art von "Entwurf", "in Bearbeitung", "festgefahren", "noch nicht fertig" usw.

Kriterien für das Hinzufügen könnten sein:

  • Prozentsatz des fertigen Buches (basierend auf dem Inhaltsverzeichnis)
  • Wenn es ein öffentliches Repo für die Quelle gibt, zeigen Sie darauf, sehen Sie nach, ob die Commits ins Stocken geraten sind oder am Leben sind (z. B. das Buch in #2252 hat ein Repo hier https://github.com/munificent/craftinginterpreters/graphs/contributors).
  • Autoren kontaktieren?

vielleicht 75 % für das Original, 50 % für Übersetzungen?

Haben Sie vielleicht eine spezielle Liste für Buchrepositorys in Bearbeitung, um die Teilnahme zu fördern?

Habe @munificent um einen Kommentar auf Twitter gebeten.

Haben Sie vielleicht eine spezielle Liste für Buchrepositorys in Bearbeitung, um die Teilnahme zu fördern?

Unterabschnitte erscheinen angemessen.

Ich bin offensichtlich voreingenommen, aber ich mag die Idee, Bücher aufzulisten, die noch in Arbeit sind. Ich würde sie auf irgendeine Weise nennen, weil die Leute überrascht sein könnten, wenn noch nicht alle Inhalte da sind.

Es besteht die reale Gefahr, dass am Ende unvollständige und aufgegebene Bücher aufgelistet werden. (Ich habe von O'Reilly gehört, dass ein überraschend großer Teil der technischen Bücher stirbt, bevor der Autor sie beendet hat.)

Wie wäre es mit der Auflistung von in Bearbeitung befindlichen Büchern wie diesen:

Am Ende einer Themenliste (ich denke, der Linter wird Emojis alphabetisch an letzter Stelle setzen, außer bei obskuren Zeichen).

Und fügen Sie eine Anleitung hinzu, dass unvollständige Bücher, die seit einem Jahr nicht weitergekommen sind, entfernt werden sollten.

„Crafting Interpreters“ wurde mit einem Emoji verschmolzen. Aufgrund der Art und Weise, wie die Linter-Listen alphabetisch geordnet werden sollen, war die Auflistung

Alternativen waren:

usw.
Ästhetische Überprüfung willkommen.

Ich bevorzuge die letztere Option, anhängen (🚧 in Bearbeitung) oder einfach anhängen (🚧), wenn eine Legende hinzugefügt wird:
* Books labeled (🚧) are still in the process of being made.

Das war lange genug ein offenes Thema. Gehen wir von diesem Format aus:

Würde eine PR für BEITRAG schätzen, damit wir das Problem schließen können.

umgesetzt.

War diese Seite hilfreich?
0 / 5 - 0 Bewertungen

Verwandte Themen

fosslinux picture fosslinux  ·  5Kommentare

iamsubhranil picture iamsubhranil  ·  6Kommentare

aminought picture aminought  ·  15Kommentare

kadhirash picture kadhirash  ·  4Kommentare

sayopaul picture sayopaul  ·  3Kommentare