HackerTrans
TopNewTrendsCommentsPastAskShowJobs

johnathandos

no profile record

Submissions

Accountability, APIs, and the United States of Surveillance

netapinotes.com
2 points·by johnathandos·vor 5 Monaten·0 comments

Three things I think about when creating product docs

johnathandos.com
1 points·by johnathandos·vor 6 Monaten·0 comments

Ask HN: What would you do if you didn't work in tech?

62 points·by johnathandos·vor 7 Monaten·141 comments

How to get Pandoc to respect custom table styles in Word templates

johnathandos.com
32 points·by johnathandos·vor 8 Monaten·2 comments

Material for MkDocs is now in maintenance mode, Squidfunk announces Zensical

squidfunk.github.io
2 points·by johnathandos·vor 8 Monaten·0 comments

comments

johnathandos
·letzten Monat·discuss
"All fixed, fast-frozen relations, with their train of ancient and venerable prejudices and opinions, are swept away, all new-formed ones become antiquated before they can ossify. All that is solid melts into air, all that is holy is profaned, and man is at last compelled to face with sober senses, his real conditions of life, and his relations with his kind."
johnathandos
·vor 3 Monaten·discuss
I think the example you give is a little backwards — a RAG system searches for relevant content before sending anything to the LLM, and includes any content retrieved this way in the generative prompt. User query -> search -> results -> user query + search results passed in same context to LLM.
johnathandos
·vor 3 Monaten·discuss
See one, do one, teach one.
johnathandos
·vor 4 Monaten·discuss
Is llms.txt really useless? I've read some recent articles claiming that if you tell an agent where to find it in an HTML comment at the top of your page, the agent will do so and then have a map to all the markdown files it can download from your site. https://dacharycarey.com/2026/02/18/agent-friendly-docs/
johnathandos
·vor 6 Monaten·discuss
Really slick. Let’s see the AI open it up so we can use it to generate a similar map for anyplace on Earth :)
johnathandos
·vor 8 Monaten·discuss
It’s good to spread awareness (or just remind folks) that alternatives to Markdown exist. The right tool for the job depends on your circumstances. If I were scaling a docset for a team of contributors primarily consisting of technical writers, .adoc or .rst would be my preference. If I were scaling internal docs-as-code infra for software engineers, I’d use Markdown.