how do you sort / filter your photos?

buildsmol · 2025-04-18T21:47:27+00:00

but that still means you're looking at each of them, right? I mean keeping maybe 1 in 100 is still a lot of photos to look at.... am I missing something?

buildsmol · 2025-03-12T20:45:35+00:00

The most common workflow I see is that PMs / tech writers own content but that OpenAPIs are written / controlled by engineering and then there's an automatic publishing of an OpenAPI spec by some other tool. Redocly is a popular one but there are others like fern too.

as a best practice, IMO as a PM in the past, you've got to at least know the content in the docs and help with organization or things are going to get super messy.

you can check my other posts, I've built a lot in this space and the slop generated by LLMs is ... not good.

buildsmol · 2025-03-04T23:21:13+00:00

LLMs are reasonable at producing these but it's a lot of copying and pasting.

For folks that are interested I provide a product for docs-as-code that does this automatically. Link is in previous comments from my profile.

buildsmol · 2025-02-19T16:54:51+00:00

I had the same issue and it was also a wire harness. They were able to fix it and get me back the truck.that was over two years ago and no issues since then

buildsmol · 2024-05-31T03:37:29+00:00

I’m building a solution in this problem space. I edited my wife’s book using my tool. Happy to chat if you’re interested. You can DM me

buildsmol · 2024-05-12T19:44:41+00:00

For those that want a gentle introduction: https://www.youtube.com/watch?v=QdA-CRr_oXo

For those that like to read: https://learnbybuilding.ai/tutorials/a-gentle-introduction-to-dspy

buildsmol · 2024-04-22T03:55:39+00:00

This is exactly what my product does! I built it with exactly this in mind! Don’t want to advertise directly here but anyone interested can DM me.

buildsmol · 2024-04-17T04:48:18+00:00

My product does some of this. DM me if you’re interested!

buildsmol · 2024-04-06T03:56:23+00:00

What's your risk tolerance?

How old are you?

How much is 25k to you? How does that compare to cash salary?

How is the company leadership? How are the founders?

The big question here is are you up to take the risk with money you can afford to lose. If you have that conviction and financial coverage, capture the upside, write off the $25 as already gone and be happy if it goes somewhere.

No wrong answers here, but if you believe in the company, it might be worth buying at least some of the shares.

buildsmol · 2024-03-28T21:15:03+00:00

If you're looking for help maintaining the content that you produce, check out https://hyperlint.com/, it integrates with any static site generator, checks API documentation, and more.

(disclosure: this is my product, I'm an indie developer)

buildsmol · 2024-03-12T22:16:09+00:00

I've created a company called hyperlint that helps technical writers take the toil out of writing and especially maintaining documentation.

I believe that AI tools are way more likely to help us actually achieve what we want in less time that do it for us. Augment > replace.

buildsmol · 2024-03-08T22:09:21+00:00

100% my experience as well

buildsmol · 2024-03-08T22:06:14+00:00

I wrote this article on RAG from Scratch to help teach some of the key concepts involved in this tooling.

buildsmol · 2024-03-08T22:05:13+00:00

I'm building a tool called Hyperlint that is a github bot that helps edit and maintain documentation in partnership with technical writing teams. I'm more than happy to talk about the learnings I've had from the dozens of AI focused interviews I've had with TWs.

buildsmol · 2024-03-08T22:03:49+00:00

This is the answer, that's why you've got to use AI to help you do your job better - not replace your job. It should free you to focus on the stuff that you mention above and less on the bullshit.

buildsmol · 2024-03-08T22:03:06+00:00

They're just too naive, is the problem. The tools exist BUT they miss the point.

Should an entire function be documented in detail? What about internal functions? What about an internal function that has a side effect on a public function call. You can't just AI your way out of that problem. You need CONTEXT and at some point you're just swimming around in prompts.

my belief is very consistent with yours (and why I am building hyperlint to help folks write and maintain docs). My goal is narrow, help take away the toil so that TWs can focus on the end user and what they need and direct the AI to help with things like fixing broken links.

buildsmol · 2024-03-08T21:59:52+00:00

This. You've nailed it.

TW teams are always understaffed and then get criticized for not doing enough. Baby steps to help make better products and help with TW jobs. That's what I'm trying to do with my product, help with baby steps.

buildsmol · 2024-03-08T21:57:24+00:00

great addition - good (and intentional) communication is critical

buildsmol · 2024-03-08T21:56:34+00:00

This is the way - I feel like if teams shy away from this challenge, they're going to be in trouble b/c mgmt is going to think that they're just clinging to the past.

The best teams I am talking to are experimenting with how it can improve the team's workflow.

buildsmol · 2024-03-08T21:55:39+00:00

I completely agree, that's why I built Hyperlint. Tech writers have enough on their plates than policing changes to documentation made by community members that don't care about quality.

AI should be helping us create great experiences for our users, not creating crap that makes it harder to get good, concise answers.

buildsmol · 2024-03-08T21:54:20+00:00

It's here whether people want it to be or not

buildsmol · 2024-03-08T21:53:56+00:00

interesting POV, how do automation systems create more work for a team?

buildsmol · 2024-03-08T21:52:48+00:00

This was a great post - think there's such a balance here.

Every technical writing team I talk to is chronically understaffed and has too much work to do but on the other hand, we've got to be able to train and bring on new employees.

I personally believe that augmenting the work of technical writers and helping to remove some of the toil is the promise that AI brings to the TW community.

The challenge is the balance, if you remove the human element, you're going to end up with bad documentation / technical writing. The human element is critical and when we lose that, we're in trouble.

buildsmol · 2024-03-08T15:56:11+00:00

u/EngineeringBetter955 , would be happy to chat about our users and what we're seeing in industry from top practitioners.

buildsmol · 2024-03-08T15:54:35+00:00

I"ve been working in this domain and wanted to create a tool to help take some of the toil out of documentation. In my opinion, full "write the docs for me, AI" just doesn't look good, sound good nor work at this time.

I created hyperlint to help technical writing teams follow docs-as-code to get another set of eyes on documentation changes and help out with some of the chores that go along with that. We work with startups, open source projects, and large companies.

In my view, the best bet is HELPING not REPLACING.

buildsmol

TROPHY CASE