Free-programming-books: Policies

Created on 6 Mar 2018  ·  5Comments  ·  Source: EbookFoundation/free-programming-books

Thank you for this amazing project!

I have a few questions about general formatting that are not answered in CONTRIBUTING.md.

  1. If it is a PDF, do we link directly to the PDF or to a website that has a link to the PDF?
  2. When there are multiple formats, but they are all available from the same website as the main one, do we just not provide a URL?
  3. And what do we do when there are three or more formats (e.g. HTML, PDF and EPUB), and there are three different URL's, how do we indicate this?

Please could this be added to CONTRIBUTING. Thank you!

help wanted

Most helpful comment

Good questions, they're touched on in the CONTRIBUTING, but it could be better. Please make a PR if you have suggestions.

  1. If there's a web page specifically about the book, that has a link to the PDF, link to the page. if not, link to the pdf.
  2. If there's a web page that links to multiple formats, link to that page.
  3. title - Author Name (format1) (format2) (format3)

All 5 comments

Unfortunately I will not be able to respond over the next three days. I will reply as soon as I can.

Good questions, they're touched on in the CONTRIBUTING, but it could be better. Please make a PR if you have suggestions.

  1. If there's a web page specifically about the book, that has a link to the PDF, link to the page. if not, link to the pdf.
  2. If there's a web page that links to multiple formats, link to that page.
  3. title - Author Name (format1) (format2) (format3)

And another question:

  1. Is it preferred to use the direct link (i.e. no 301 redirects) or the shorter link?

Thanks!

we don't want link shortener links, or cloaked links, but redirects are ok if they make sense. Links that resolve to "file sharing sites" are not generally permitted.

answers moved to Wiki

Was this page helpful?
0 / 5 - 0 ratings

Related issues

Tlalanne picture Tlalanne  ·  4Comments

eshellman picture eshellman  ·  18Comments

eshellman picture eshellman  ·  5Comments

eshellman picture eshellman  ·  5Comments

harrykar picture harrykar  ·  9Comments