logoalt Hacker News

artemonster • 02/20/2025 • 2 replies • view on HN

Oh, looks interesting, lets check out the architecture documentation! searching.... Ah, found it: Makefile and manual.tex... Yeah, f off :)

Replies

Joker_vD • 02/20/2025

While I agree that repos with docs should have "releases", in GitHub parlances, with compiled PDFs/ebooks/whatever, building it yourself is as simple as

    git clone https://github.com/f8-arch/doc.git f8-doc && cd f8-doc
    docker run --rm -v "$(pwd)":/data fabtesta/ubuntu-xelatex make  # or any other container with XeLaTeX that you trust
    xdg-open manual.pdf
The future is now, old man.
➕ show 1 reply
PhilipRoman • 02/20/2025

Out of curiosity, what would you prefer? I wouldn't say tex is my all time favorite format, but definitely better than 90% of the documentation solutions out there.

➕ show 1 reply