Which format for API documentation programmers prefer: PDF or Web?
3rd December 2013
My answer to Which format for API documentation programmers prefer: PDF or Web? on Quora
HTML is a better format for documentation than PDF.
Documentation needs to be easy to access, easy to bookmark, easy to share links to and easy to copy and paste from.
PDFs are lousy for linking to (you can link to the whole document but not to individual sections) and frequently cause weird issues when copy and pasting.
The two advantages of PDF are that you (the author) get more control over how it prints and it’s easier for the end user to download as a single file for offline reading.
If you think these issues are important to your audience you can solve them with HTML by including a good print stylesheet and a zip file for download of all HTML and assets. You could also use a documentation system such as http://sphinx-doc.org/ which can generate both HTML and PDF versions.
More recent articles
- Weeknotes: Llama 3, AI for Data Journalism, llm-evals and datasette-secrets - 23rd April 2024
- Options for accessing Llama 3 from the terminal using LLM - 22nd April 2024
- AI for Data Journalism: demonstrating what we can do with this stuff right now - 17th April 2024
- Three major LLM releases in 24 hours (plus weeknotes) - 10th April 2024
- Building files-to-prompt entirely using Claude 3 Opus - 8th April 2024
- Running OCR against PDFs and images directly in your browser - 30th March 2024
- llm cmd undo last git commit - a new plugin for LLM - 26th March 2024
- Building and testing C extensions for SQLite with ChatGPT Code Interpreter - 23rd March 2024
- Claude and ChatGPT for ad-hoc sidequests - 22nd March 2024
- Weeknotes: the aftermath of NICAR - 16th March 2024