Which format for API documentation programmers prefer: PDF or Web?
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: Parquet in Datasette Lite, various talks, more LLM hacking - 4th June 2023
- It's infuriatingly hard to understand how closed models train on their input - 4th June 2023
- ChatGPT should include inline tips - 30th May 2023
- Lawyer cites fake cases invented by ChatGPT, judge is not amused - 27th May 2023
- llm, ttok and strip-tags - CLI tools for working with ChatGPT and other LLMs - 18th May 2023
- Delimiters won't save you from prompt injection - 11th May 2023
- Weeknotes: sqlite-utils 3.31, download-esm, Python in a sandbox - 10th May 2023
- Leaked Google document: "We Have No Moat, And Neither Does OpenAI" - 4th May 2023
- Midjourney 5.1 - 4th May 2023
- Prompt injection explained, with video, slides, and a transcript - 2nd May 2023