Free-programming-books: critérios para livros "em andamento"

Criado em 17 mai. 2017  ·  9Comentários  ·  Fonte: EbookFoundation/free-programming-books

cada vez mais, há sugestões para adicionar livros inacabados ou "em processo" a esta lista, por exemplo #2252

Que critérios devem ser usados ​​para adicionar este tipo de livro?

PR requested discussion

Comentários muito úteis

que tal listar livros em processo como este:

No final de uma lista de tópicos (acho que o linter colocará o emoji por último em ordem alfabética, exceto caracteres obscuros).

E acrescente a orientação de que livros incompletos que não avançaram em um ano devem ser removidos.

Todos 9 comentários

Talvez adicioná-lo com um rótulo após o link na lista? Tipo de "rascunho", "em andamento", "parado", "ainda não concluído", etc.

Os critérios usados ​​para adicioná-los podem ser:

  • porcentagem do livro finalizado (com base no índice)
  • se houver um repositório público para a fonte, aponte para ele, veja se os commits pararam ou estão vivos (por exemplo, o livro em #2252 tem um repositório aqui https://github.com/munificent/craftinginterpreters/graphs/contributors)
  • contato com autores?

talvez 75% para original, 50% para traduções?

Talvez tenha uma lista especial para recompras de livros em processo, para ajudar a incentivar a participação?

Pedi a @munificent para comentar no twitter.

Talvez tenha uma lista especial para recompras de livros em processo, para ajudar a incentivar a participação?

As subseções parecem apropriadas.

Obviamente sou tendencioso, mas gosto da ideia de listar livros que ainda estão em andamento. Eu os chamaria de alguma forma porque as pessoas podem se surpreender se todo o conteúdo ainda não estiver lá.

Existe um risco real de acabar listando livros incompletos e abandonados. (Ouvi de O'Reilly que uma fração surpreendentemente grande de livros técnicos morre antes que o autor os termine.)

que tal listar livros em processo como este:

No final de uma lista de tópicos (acho que o linter colocará o emoji por último em ordem alfabética, exceto caracteres obscuros).

E acrescente a orientação de que livros incompletos que não avançaram em um ano devem ser removidos.

"Crafting Interpreters" foi mesclado com um emoji. Devido à forma como o linter deseja que as listas sejam alfabetizadas, a listagem foi

As alternativas eram:

etc.
Revisão estética bem-vinda.

Eu prefiro a última opção, anexar (🚧 em processo) ou apenas anexar (🚧) se uma legenda for adicionada:
* Books labeled (🚧) are still in the process of being made.

Esta tem sido uma questão em aberto há muito tempo. Vamos com este formato:

Agradeceríamos um PR por CONTRIBUIR para que possamos encerrar a questão.

implementado.

Esta página foi útil?
0 / 5 - 0 avaliações

Questões relacionadas

harrykar picture harrykar  ·  9Comentários

kaleemullah360 picture kaleemullah360  ·  8Comentários

ghost picture ghost  ·  7Comentários

VicoSilalahi picture VicoSilalahi  ·  4Comentários

Tlalanne picture Tlalanne  ·  4Comentários