free-science-books icon indicating copy to clipboard operation
free-science-books copied to clipboard

Format for submitted links

Open onebree opened this issue 10 years ago • 15 comments

Unlike programming books, science references have been around for decades, with some subjects rarely updating (math). I think the following should be included when submitting a link

  • Title of work/reference
  • Format of reference (PDF, HTML, Repository, PPT), unless it is a course
  • Author of reference
    • includes PDF, HTML, Repos
    • Excludes wiki-based material (like wikibooks)
  • Year published -- excludes constantly modified works (Wikis, Repos)

I am not sure on the exact format. So far, it looks like @eshellman is formatting it as:

<title> <format> by <author>.

The programming repo does not form it into a sentence, and replaces "by" with " - ".

Any changes we decide here, I will put in my future PR that edits the contributing file.

onebree avatar Sep 10 '15 13:09 onebree

Personally I like indications when the target of a link is pdf or epub, i.e. not a web page. Also notations when there's no download - as in [online book]. Also, should make clear that affiliate links are not acceptable.

Also look at: https://sn.reddit.com/r/freeEBOOKS/search?q=flair%3AScience&restrict_sr=on&sort=new&t=all#science

eshellman avatar Sep 10 '15 14:09 eshellman

Yes, we can assume that references are HTML/webpages, unless otherwise specified. I think we should also note whether accounts are required (like how online courses work). What do you mean by affiliate link? I do not agree with personal accounts like Dropbox, Google Drive, or even torrents.

Maybe we can have a key at the end, full of superscript endnotes? Or even an emoji picture (if there is one)

onebree avatar Sep 10 '15 15:09 onebree

affiliate links are those that direct revenue to the linker, i.e. https://affiliate-program.amazon.com/

eshellman avatar Sep 10 '15 16:09 eshellman

Okay, makes sense... Could you give me an example of a free ebook that is from an affiliate link?

onebree avatar Sep 10 '15 17:09 onebree

http://www.amazon.com/gp/product/B00XJHMDZG/ref=as_li_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=B00XJHMDZG&linkCode=as2&tag=gotohe-20&linkId=XZZAWBX6XW46DOPW

eshellman avatar Sep 10 '15 18:09 eshellman

Oh, I understand. I know FPB recently added a book that Microsoft released. What about something like that?

Microsoft Press: Free E-Books

onebree avatar Sep 10 '15 18:09 onebree

The microsoft press books are fine

eshellman avatar Sep 10 '15 18:09 eshellman

Okay, I was just making sure... I agree with NO affiliate links then. You have any ideas on a final format per list item?

onebree avatar Sep 10 '15 18:09 onebree

Right now, a "final format" would be a premature optimization

eshellman avatar Sep 10 '15 18:09 eshellman

Could we use this format:

for books with 4 authors?

And the book with 2 authors or more?

ghost avatar Jun 08 '17 16:06 ghost

sure, "et al."

eshellman avatar Jun 08 '17 17:06 eshellman

All the "." at the end of line could be removed.

ghost avatar Jun 08 '17 20:06 ghost

I agree. I will add a linter and travis ci config.

eshellman avatar Jun 08 '17 21:06 eshellman

Can I add this :

?

It's the best link for this book that I found.

ghost avatar Jun 09 '17 16:06 ghost

sure. I'm surprised it's not in free programming books.

eshellman avatar Jun 09 '17 16:06 eshellman