johnathandos

6 ms·

1.
by johnathandos 3mo ago
"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 p
2.
by johnathandos 6mo ago
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 -> result
3.
by johnathandos 6mo ago
See one, do one, teach one.
4.
by johnathandos 6mo ago
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 downl
5.
Accountability, APIs, and the United States of Surveillance(netapinotes.com)
2 points by johnathandos 7mo ago|0 comments
6.
by johnathandos 8mo ago
Really slick. Let’s see the AI open it up so we can use it to generate a similar map for anyplace on Earth :)
7.
Three things I think about when creating product docs(johnathandos.com)
1 points by johnathandos 9mo ago|0 comments
8.
Ask HN: What would you do if you didn't work in tech?
62 points by johnathandos 9mo ago|141 comments
9.
How to get Pandoc to respect custom table styles in Word templates(johnathandos.com)
32 points by johnathandos 10mo ago|2 comments
10.
by johnathandos 10mo ago
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 writ
11.
Material for MkDocs is now in maintenance mode, Squidfunk announces Zensical(squidfunk.github.io)
2 points by johnathandos 10mo ago|0 comments
12.
by johnathandos 1y ago
This really depends on where you first encountered the term. Anne Gentle wrote Docs Like Code, the first book I read on this topic 8 years ago. I always consider the terms "docs as code" and "docs like code" to be interc
13.
by johnathandos 2y ago
Thanks for sharing this post from Michelle, just shared it with some leaders at my company!
14.
by johnathandos 2y ago
You're not wrong. Business is a tough environment. At a gut level the post seems sensible to me, and it does generate a lot of ideas about how I can make my own docs better. That's not enough, though, if I want the folks who think
15.
by johnathandos 2y ago
Thanks for sharing. A couple of thoughts. It seems like it's a lot harder to measure whether your docs are helping people make good decisions than it is to measure whether they are helping people successfully accomplish a task. I think
16.
by johnathandos 2y ago
Aren’t we all just offset normies?
17.
by johnathandos 4y ago
Someone is out there building and maintaining the APIs
18.
by johnathandos 4y ago
To be clear, I don’t mean when you’re cold-emailing someone for an intro or a favor you don’t need. I mean when you have a dependency at work and can’t move forward without information from someone else.
19.
by johnathandos 4y ago
Agree with the premise, and it can be more effective to choose a different medium for your follow-up communication. Someone not responding to email? Try sending an IM or giving them a phone call.
20.
Documentation-Driven API Design(medium.com)
2 points by johnathandos 5y ago|0 comments
21.
Portugal bans companies from contacting remote employees after work(nytimes.com)
2 points by johnathandos 5y ago|0 comments
22.
by johnathandos 6y ago
If I were the manager, I’d respond to this by wishing the person luck and asking when their last day will be.