Skip to content


Subversion checkout URL

You can clone with
Download ZIP
the Open-Advice book
Branch: master

Merge pull request #74 from jerrykan/typos

Fix typo in Gareth J. Greenaway's bio
Failed to load latest commit information.
artworkdesign A typo - character-toll instead of character-tall
business fix a few errors reported in #54
code Improved wording, approved by Thiago.
communitymanagement Changed learn to teach in Bacon's chapter.
conferencessprints Fix typo in Gareth J. Greenaway's bio
documentationsupport the technology -> technology
hardware rough structure for the book
ideasinnovation Show author/chapter/bio in html properly.
infrastructure Show author/chapter/bio in html properly.
legalpolicy "To determined" --> "to determine" (issue #67)
mentoringrecruiting Trying to make a sentence less awkward in Hawthorn's chapter.
packaging Added a missing article in Untz's chapter.
promotion "They team" --> "the team" (issue 64)
qualityassurance Added a transition in Pulido's chapter.
research Change noun from singular to plural Ortega's chapter.
translation build -> built
usability Show author/chapter/bio in html properly.
.gitattributes let git know tex files are tex
.gitignore Add front cover to pdf version.
Makefile Fix epub justification.
Open-Advice.sty Show author/chapter/bio in html properly.
Open-Advice.tex fix Shane Coughlan spelling
Open-Advice.xmp add license in metadata change formatting
artworkdesign.tex initial import for Mairin
business.tex initial import for Carlo
cc-by-sa.png Single out style hacks and the custom top-matter.
closingwords.tex section -> chapter
code.tex Add 'Writing Patches' chapter
communitymanagement.tex add to build
conferencessprints.tex reorder Noirin's and Dave's part
documentationsupport.tex initial import for Atul
foreword.tex There was an ambiguity in the footnote which people stumbled over. Mi…
frontcover.jpg Resize to cover to A5 proper.
frontcover.pdf Add front cover to pdf version.
hardware.tex chapter -> part and section -> chapter
ideasinnovation.tex initial import for Evan
infrastructure.tex initial import for Austin
legalpolicy.tex initial import for Shane
mentoringrecruiting.tex move essay to different part of the book
packaging.tex remove finished todo
promotion.tex initial import for Sally
qualityassurance.tex chapter -> part and section -> chapter
research.tex initial import for Felipe
textforcover.txt improve cover text with Riddell's and Will's help
thankyou.tex Eugene didn't have time for the cover
topmatter.tex improve dedication
translation.tex chapter -> part and section -> chapter
usability.tex initial import for Federico

Open Advice

This is the repository for the Open Advice book. You can find the LaTeX source of the book here.

Building a PDF

To build a pdf file out of the LaTeX source install pdflatex and run the command


If you don't have make, you can run:

pdflatex Open-Advice

To build all other formats run:

make all

Updating the book after changes

If you have made local changes to the source of the book and want to render a PDF again:

make clean

Installing pdflatex

On Debian-based systems, you can install "pdflatex" with:

sudo apt-get install texlive-latex-extra

On Gentoo-based systems, "pdflatex" and required extra pacakges can be installed with:

emerge texlive-latexrecommended xcolor


"File `todonotes.sty' not found."

This means you need to run the above apt-get command, because you are missing one of the LaTeX extra packages.

"File `tocstyle.sty' not found."

If your distro doesn't have that you can download it from and place it in the root directory of the book.

Project Statistics

Project activity is tracked by - see for details.

Referencing This Book

To reference this book, you may use the following Bibtex citation:

author = {Greve, Georg and Hemel, Armijn and Prodromou, Evan and Kr\"{o}tzsch, Markus and Ortega, Felipe and Hawthorn, Leslie and Ottens, K\'{e}vin and Pintscher, Lydia and Mitchell, Jeff and Appel, Austin and Macieira, Thiago and Bergius, Henri and Blin, Kai and Pulido, Ara and Klapper, Andre and Leto, Jonathan and Jha, Atul and Bowen, Rich and Gentle, Anne and McCance, Shaun and Bhattacharjee, Runa and Paumier, Guillaume and Quintero, Federico Mena and Strode, M\'{a}ir\'{\i}n Duffy and Trounev, Eugene and Kaye, Robert and Bacon, Jono and Leisse, Alexandra and Riddell, Jonathan and May, Thom and Untz, Vincent and Jarvis, Stuart and Poortvliet, Jos and Khudairi, Sally and Plunkett, N\'{o}ir\'{\i}n and Neary, Dave and Greenaway, Gareth J. and Deckelmann, Selena and Adam, Till and Karlitschek, Frank and Daffara, Carlo and Jaeger, Till and Coughlan, Shane},
editor = {Pintscher, Lydia},
isbn = {9781105514937},
keywords = {foss,open source,oss},
pages = {1--310},
title = {{Open Advice: FOSS: What We Wish We Had Known When We Started}},
url = {},
year = {2012}


The book and its content is licenced under CC-BY-SA. For questions about the book contact Lydia Pintscher at

Something went wrong with that request. Please try again.