Free-programming-books: criteria for "in process" books

Created on 17 May 2017  ·  9Comments  ·  Source: EbookFoundation/free-programming-books

increasingly, there are suggestions to add unfinished or "in process" books to this list, for example #2252

What criteria should be used for adding this sort of book?

PR requested discussion

Most helpful comment

how about listing in-process books like this:

At the end of a topic list (I think the linter will put emoji last alphabetically except for obscure characters).

And add guidance that incomplete books which haven't advanced in a year should be removed.

All 9 comments

Maybe adding it with a label after the link in the list? Sort of "draft", "in process", "stalled", "not finished yet", etc.

Criteria used for adding them could be:

  • percentage of finished book (based on table of contents)
  • if there's a public repo for the source, point at it, see if the commits have stalled or are alive (e.g. the book in #2252 has a repo here https://github.com/munificent/craftinginterpreters/graphs/contributors)
  • contacting authors?

maybe 75% for original, 50% for translations?

Maybe have a special list for in-process book repos, to help encourage participation?

Have asked @munificent for comment on twitter.

Maybe have a special list for in-process book repos, to help encourage participation?

Subsections seem appropriate.

I'm obviously biased, but I like the idea of listing books that are still underway. I would call them out in some way because people might be surprised if all the content isn't there yet.

There is a real risk of ending up listing books that are incomplete and abandoned. (I heard from O'Reilly that a surprisingly large fraction of technical books die before the author finishes them.)

how about listing in-process books like this:

At the end of a topic list (I think the linter will put emoji last alphabetically except for obscure characters).

And add guidance that incomplete books which haven't advanced in a year should be removed.

"Crafting Interpreters" was merged with an emoji. Because of the way the linter want lists to be alphabetized, the listing was

Alternatives were:

etc.
Aesthetic review welcome.

I prefer the latter option, append (🚧 in process), or just appending (🚧) if a legend is added:
* Books labeled (🚧) are still in the process of being made.

This has been an open issue long enough. Let's go with this format:

Would appreciate a PR for CONTRIBUTING so we can close the issue.

implemented.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

rosepac picture rosepac  ·  3Comments

ghost picture ghost  ·  7Comments

kakashi215 picture kakashi215  ·  10Comments

eshellman picture eshellman  ·  5Comments

hiverkiya picture hiverkiya  ·  5Comments