progit2

So I just crushed the pngs which brings this down to 80M, but the problem is the mobi format that is produced by kindlegen. I cover the issue here: https://github.com/progit/progit2/issues/116 But basically Amazon produces a file with three files in it - the ePub source, the older mobi7 format and the newer k8 format. This file is meant to be uploaded to Amazon so you can download it from them. Amazon figures out what Kindle you have and sends you the correct version from this file instead of the whole 80M. It's unfortunate, but I'm not sure if I even _can_ take a single format out of the bundle. If you have a newer Kindle, you should just be able to send the ePub or PDF to it. I'm not sure if it would be a lot worse or not though, I'll try it out.

OK, Play appears to be pretty strict about xrefs for some reason. I'll look into it. You can track the issue here: https://github.com/progit/progit2/issues/111

There is a simple build process using asciidoctor-pdf and asciidoctor-epub that can also create all 3 formats locally. The Atlas ones are just a little more professional looking, but the asciidoctor chain is still really great. https://github.com/progit/progit2#how-to-generate-the-book

I do actually cover this in the preface: https://github.com/progit/progit2/blob/master/book/preface.a... The conflict of interest does bother me, so I did try to be as clear as I could about it and to point out at the beginning of the chapter that you could easily skip it if you don't like or don't want to use GitHub. I also stayed away from everything I could that required payment. The truth is that I've been approached to write books specifically about GitHub for several years so I thought that the demand for that sort of information was high enough to warrant moving it to it's own chapter. Had I been approached about writing about other resources I would probably have also included them. The more difficult decision was whether to include information on Gerrit. I actually started writing a section on it, then considered a chapter or app