HNHacker News
TopNewBestAskShowJobs

remoquete

1,189 karma · joined October 2, 2019

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

My site: https://passo.uno

submissionscomments
remoquete··on A Marriage Proposal Spoken in Office Jargon
It reads like a script from Succession.
remoquete··on Show HN: Doom (1993) in a PDF
Now, if only I could type IDDQD to print protected PDF files.
remoquete··on The Seven-Action Documentation Model
Hi there! I'm the author of the Seven-Action Docs Model.

Big yes. I think the 7A model is fully compatible with the likes of Diataxis, or with pragmatic initiatives such as The Good Docs Project [1].

1. https://www.thegooddocsproject.dev/

remoquete··on Rules for writing software tutorials
Diataxis gets often linked around here. It's simple, but by no means the solution to great docs. For more info, see https://idratherbewriting.com/blog/what-is-diataxis-document...
remoquete··on Ask HN: Where to Work After 40?
Yeah, the increase in productivity thanks to LLMs makes the need to hire a junior writer or a contractor less pressing. Way less.

I guess that's why I'm developing my coding lifeboat on the side.

remoquete··on Ask HN: Where to Work After 40?
I'm 42 and have been working as a technical writer since I was 26. I'd argue that technical writing is one of those fields where you can comfortably work until retirement. Many in my field think AI will take their job — I think otherwise. I'm now working as a Documentation Engineer, using LLMs daily to speed up my work.

But I'm also learning Rust on the side. Guess it'll never be late for that move?

remoquete··on One of my papers got declined today
Folks already do. They often turn them into inspirational tales.
remoquete··on Show HN: API Parrot – Automatically Reverse Engineer HTTP APIs
Looks very interesting. Does it produce an OpenAPI file? That'd help immensely in documenting APIs that lack specifications.
remoquete··on One of my papers got declined today
I find it refreshing when researchers disclose their own failures. Science is made of negative results, errors, and rejections, though it's often characterized in a much different, unrealistic way.

By the way, even though some of you may know about it, here's the link to the Journal of Negative Results: https://www.jnr-eeb.org/index.php/jnr

remoquete··on Arnis: Generate cities in Minecraft from OpenStreetMap
Can't describe the excitement that tools like thise bring to me. I remember when we used to create cities in Sim City 2000 and then navigate them in Sim Copter and Streets of Sim City. I'm hoping to see something similar happening with photo-realistic levels of accuracy.
remoquete··on Manx – a catalog of manuals for old computers
I love old manuals. I partially answered that question here: https://passo.uno/why-collect-read-old-computer-manuals/
remoquete··on Ask HN: Examples of agentic LLM systems in production?
Cost saving as in...? Hopefully not saving through making human employees redundant.
remoquete··on Sora is here
While it's indeed fascinating, part of me finds the sheer energy expenditure to be problematic, not to mention the "Hollywood is dead" innuendos.
remoquete··on Sora is here
Ah, yes. We definitely needed another bad dreams generator.
remoquete··on The 70% problem: Hard truths about AI-assisted coding
Pretty much everything the author describes applies to technical writing, too. Thinking AI can replace senior writers is delusional.
remoquete··on Gladiators in ancient Anatolia lived to entertain the masses
You can re-edit it to preserve the How though.
remoquete··on Serious fun
And also "Ekke Ekke Ekke Ekke Ptang Zoo Boing!", of course.
remoquete··on Serious fun
As John Cleese once said, “serious doesn’t inevitably mean solemn”.
remoquete··on What docs-as-code means
My post wasn't concerned with internal code documentation. Seems like we're having parallel conversations.
remoquete··on What docs-as-code means
It's known. Example: https://mintlify.com/blog/stripe-docs
remoquete··on What docs-as-code means
Sad to read your n=20 was like that. There are also cases where documentation led companies to growth—one example is Stripe.

Poking the finger at documentation is easy because it's visible and readily available. Would you say the bit rot phenomenon you described never happened to code, or processes, or UIs? Docs reflect organizations.

remoquete··on What docs-as-code means
> When I'm working collaboratively and I hear people tell me what I'm doing is not important, I have to believe there is some truth to it.

No, you don't have to. And that's the whole point.

remoquete··on What docs-as-code means
Author here. What do you mean by depth and breadth?
remoquete··on What docs-as-code means
You need good source material, including docs, to have LLMs generate docs that are accurate, reliable, and safe. LLMs have interesting applications in areas like SDK and API docs, for sure, but can't replace an entire function.
remoquete··on What docs-as-code means
Thanks! It's a tweaked version of https://github.com/mrmierzejewski/hugo-theme-console
remoquete··on What Docs-as-Code Means
And the resulting failed documentation, I guess.
remoquete··on What docs-as-code means
Author here. No, I don't think it does. https://passo.uno/ai-anxiety-tech-writer-howto/
remoquete··on It's hard to write code for computers, but it's harder to write code for humans
Oh, you still code in Visual Basic? Fascinating. May I ask what's the use case and how are you finding coding in VB these days?
remoquete··on Gnome 47 Wallpapers
All wallpapers are available here: https://gitlab.gnome.org/GNOME/gnome-backgrounds/-/tree/gnom...

Windows and macOS users, notice that they're in JXL format. You'll need a converter to use them as wallpapers on your machine.

remoquete··on The Palletrone is a robotic hovercart for moving stuff anywhere
Not sure if they knew about this or Kojima predicted the future, but a conceptually similar floating carrier was in Death Stranding: https://deathstranding.fandom.com/wiki/Floating_carrier

Maybe games inspire life?

← PreviousPage 2 of 8Next →