Format for submitted links

[onebree]

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.

[eshellman]

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

[onebree]

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)

[eshellman]

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

[onebree]

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

[eshellman]

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

[onebree]

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

Microsoft Press: Free E-Books

[eshellman]

The microsoft press books are fine

[onebree]

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

[eshellman]

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

[ghost]

Could we use this format:

• Wisconsin Calculus (PDF) by Sigurd B. Angenent et al

for books with 4 authors?

And the book with 2 authors or more?

[eshellman]

sure, "et al."

[ghost]

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

[eshellman]

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

[ghost]

Can I add this :

• Mathematics For Computer Science, by Eric Lehman et al. (2017)

?

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

[eshellman]

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