Hacker News new | past | comments | ask | show | jobs | submit login

Feedback: The homepage (https://hurl.dev/) doesn't really make it clear - is this an interactive tool or not?

If I understand it correctly, you're supposed to save that example as a file and run 'hurl example.hurl'. It would make it easier to understand if that sample code box had a headline saying e.g. [example.hurl].




I'm not the author, but after reading the manual (https://hurl.dev/docs/manual.html), it seems to me that the tool can be used both ways. That being said, i think the value of this tool (beyond a tool like curl, wget, etc.) is that its likely preferable to base usage on non-interactive use, or at least leverage the tool via its .hurl files. While i actually like the succinctness of the homepage in describing this tool, you're not wrong that the author could have added an additional sentence stating the interactive or not point slightly more clearly. Even still, the documentation is much better for this tool, than other tools that i have seen. For this i'm thankful!


Noted, I'll try to make it clearer. We’ve been more explicit on the samples page [1]

[1] https://hurl.dev/docs/samples.html


Would it be more clear if we put line numbers in Hurl file snippets (even on the home)? I like the simplicity of our docs, but I can understand that it isn't clear how to use it. By the way, that's why we have put an asciinema animation on the home page, starting with `vim my_file.hurl`


It would help a little bit, yeah.




Consider applying for YC's Summer 2025 batch! Applications are open till May 13

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

Search: