Hacker Newsnew | past | comments | ask | show | jobs | submit | strongbond's commentslogin

No it's not. The whole presentation of it is confusing. Sorry.

This is a low quality, extremely low quality comment. What in particular did you find confusing?

Maybe Open AI shouldn't be so stabable?


I think it sucks. Sorry to be the harbinger of negative opinion, but that's just what I feel about it.


Mind to elaborate what sucks? Your comment adds nothing.


Requires sign-in the moment you want to explore. Hard no from me. Cooking is even harder when you have to deal with mandatory sign-ins.


Thanks for that insightful feedback, I honestly did not even consider that. I'll go ahead and remove the sign in requirement for the create recipe page since it does really work well.


All done, no sign-in requirement on the create recipe page. Thanks!

https://preppear.com/recipes/new


You also need good writers who by example make it perfectly clear what's what.


I don't know if it's perfect, but I have yet to meet anything better. I discovered it late in my 20-year technical writing career, and it felt like meeting an old friend for the first time.


The trouble with DITA is that it is very often accompanied by its own very opinionated toolchain, although of course it's not mandatory. There are better ways to write docs nowadays than wrestle with XSL/FO and its brethren.


I've found https://diataxis.fr/ to be an excellent framework on which to hang documentation efforts. It helps you to understand what kinds of documentation resources help users most.


Good article, made less so by the over-large and gratuitous stock photos.



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: