Comment

Comment by jbdamask

Appreciate you trying it and commenting. And I'm sorry that you hit this bug on first contact. My goal is to have a dead-simple UX, not waste your time trying to get it working. Heck, the whole point of Rocky Surf is convenience.

I've filed this as a bug.

Per your comment about the documentation - I agree that the docs aren't great for humans. In fact, they're meant to be read by agents, not humans. But I don't make this clear anywhere.

During this build, my development agents were instructed to be verbose with documentation. I find that this improves code quality and architectural consistency across multiple agent sessions - Rocky Surf was built over hundreds of agent sessions. The trade-off is that there's too much for humans to read.

As I got closer to release, I read, edited, and pruned a considerable amount of verbiage, but stopped short of making concise docs a release requirement. But the fact that you noticed that a particular doc was 40 pages tells me that I didn't value your time as much as I should have. Duly noted.

Development and new releases will continue since I use Rocky Surf all the time. In fact, I recently found that it pairs nicely with Herdr https://x.com/jbdamask/status/2099110104037494963?s=20

Thanks again for trying it and commenting. You didn't have to give me feedback but you did, and that's really nice.

parent jbdamask 1 month ago

No comments yet

Be the first to share your thoughts.

Live from the official Hacker News API

A modern reader for Hacker News · SvelteKit + Skeleton