Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

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



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.


I know how to do it. The sheer audacity that I am being asked to do it rubs me the wrong way. Once I am on my phone, then I am on my work pc with no rights. Then by the time I got home i have lost my interest


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.


A clickable PDF. Dont ask me to jump through loops and hoops to read about your stuff




Consider applying for YC's Fall 2025 batch! Applications are open till Aug 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: