HNHacker News
TopNewBestAskShowJobs

theletterf

2,435 karma · joined October 2, 2019

I'm a technical writer and aspiring developer based in Barcelona, Spain

https://passo.uno

submissionscomments
theletterf··on Teletext in North America
Same in Italy: https://www.televideo.rai.it
theletterf··on AGENTS.md – Open format for guiding coding agents
Yes! That was precisely my point here: https://news.ycombinator.com/item?id=44837875
theletterf··on My AI-driven identity crisis
As a tech writer, I feel like I'm becoming a context curator: I'll still write, with AI being one of the readers. https://news.ycombinator.com/item?id=44837875
theletterf··on We keep reinventing CSS, but styling was never the problem
Ah dangit. I was expecting a deeper conclusion. Then I checked on GPTZero and turns out the article is very likely to be AI-made. The header, too (you can tell). I'm not sure I should be taking advice from an LLM...
theletterf··on My ancestors fought in WWII. Hiroshima is plagued by shallow reading
https://archive.is/20250808195317/https://www.washingtonpost...
theletterf··on AI must RTFM: Why tech writers are becoming context curators
Nope, I didn't use an LLM. Disclaimer is in the footer. :)
theletterf··on AI must RTFM: Why tech writers are becoming context curators
Indeed. :)
theletterf··on AI must RTFM: Why tech writers are becoming context curators
One can only hope. :)
theletterf··on AI must RTFM: Why tech writers are becoming context curators
No, not a majority yet. Forgot to add "bleeding edge" :)
theletterf··on AI must RTFM: Why tech writers are becoming context curators
Oh, I remember. I'm an OpenAPI fan, for example. This time it feels a bit different, though. It won't erase the requirement of having high skill engineers, nor the need to have tech writers create docs, but it might indeed help focus on docs under a different light: not as a post-factum, often neglected artifact, but as a design document. I'm talking of actual user docs here, not PRFAQs or specs.
theletterf··on AI must RTFM: Why tech writers are becoming context curators
I'm hoping they'll be the docs themselves, written before the project is out.
theletterf··on AI must RTFM: Why tech writers are becoming context curators
That's why I feel tech writers need step in and help.
theletterf··on AI must RTFM: Why tech writers are becoming context curators
I think some are doing just that, yes, which I guess would only increase entropy. So it's not just curation, but also design through words. Good old specs, if you want.
theletterf··on AI must RTFM: Why tech writers are becoming context curators
Author here: If the LLM revolution helps us get more accessible and better docs, I, for one, welcome it.

Edit: I guess some commenters misunderstood my message. I'm saying that by serving also the needs of LLMs we might get more resources to improve docs overall.

theletterf··on AI must RTFM: Why tech writers are becoming context curators
Could you elaborate?
theletterf··on Show HN: I spent 6 years building a ridiculous wooden pixel display
I do! https://passo.uno/best-tech-writing-books/
theletterf··on Show HN: I spent 6 years building a ridiculous wooden pixel display
A refresh rate of 370 microhertz gives "Calm Technology" a whole new meaning. I love it.

https://en.wikipedia.org/wiki/Calm_technology

theletterf··on Twenty Eighth International Obfuscated C Code Contest
Ah, obfuscated code, the mark of a genuinely human developer. :-)
theletterf··on Show HN: I made a website that makes you cry
A piece of music that always makes me cry is Gavin Bryars' Jesus Blood Never Failed Me Yet.

https://youtube.com/playlist?list=OLAK5uy_njWv6ssGZFL5TYEDOf...

theletterf··on Java is still worth learning
Especially sentences like these:

"This wasn’t just about type safety – it was about reducing the mental burden of programming."

The "x wasn't just about n — it was about m" carry a strong LLM smell.

theletterf··on How I build software quickly
Wrote the docs equivalent :) https://news.ycombinator.com/item?id=44635184
theletterf··on Reflections on OpenAI
For a company that has grown so much in such a short time, I continue to be surprised by its lack of technical writers. Saying docs could be better is an euphemism, but I still can't find fellow tech writers working there. Compare this with Anthropic and its documentation.

I don't know what's the rationale for not hiring tech writers other than nobody suggesting it yet, which is sad. Great dev tools require great docs, and great docs require teams that own them and grow them as a product.

theletterf··on Santa Ragione says Apple is delisting Wheels of Aurelia 'without justification'
I don't think you're talking of the same game. https://mrdavepizza.com/wheels-of-aurelia/
theletterf··on Why English doesn't use accents
Urbino is more like Central Italy.
theletterf··on Don’t use “click here” as link text (2001)
A similar a11y battle is positional language, for example" "The image below" is positional language that might not mean anything to visually impaired users or folks using different layouts.
theletterf··on Let's Talk About Writing in Tech
Then they weren't doing their job well.
theletterf··on Let's Talk About Writing in Tech
The posts has a promising start, then abruptly ends.

Yes, developers need to improve writing skills. A good book on the matter is Chris Ward's Technical Writing for Software Developers, which I reviewed here: https://passo.uno/review-technical-writing-software-develope...

They also need to hire technical writers. Did the author know they exist?

theletterf··on Writing documentation for AI: best practices
Don't fall into the trap of the new SEO for AIs. LLM are just like users. https://passo.uno/writing-for-llms-ai-chatbots/
theletterf··on Is documentation like pineapple on pizza?
Answer: You might need a technical writer. https://passo.uno/signs-need-tech-writer/

And before someone links Yet Another Docs Framework, I recommend taking a different approach: https://passo.uno/beyond-content-types-presentation/

theletterf··on Jokes and Humour in the Public Android API
This means jokes and humour in technical documentation. While it's often frowned upon, I love a bit of humour in docs. I wrote about this here:

https://passo.uno/experiment-humour-documentation/

← PreviousPage 4 of 5Next →