Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Thank you for listening!

I'm just telling you about my experience. Obviously Nyxt is very different from more conventional browsers. I'm an Emacs and StumpWM user, and I'd love to have the same kind of power in browser environment. But without easily accessible docs it's just a little bit too high barrier for me.

> it would drift from different versions people were using

Good point. Maybe as a first step just copy that paragraph from readme file to a more prominent place on site? It's very unusual for a project site to have no manual.

Then make the latest version of docs available online. It should be clear 1) what version it talks about, 2) how to check version of user's installation, and 3) how to open the embedded help.

Then if really needed add docs for previous versions, like some projects do. For instance https://www.postgresql.org/docs/current/index.html.

I suppose at least some basic concepts have been stable enough to not change anytime soon?

Or does Nyxt still change substantially from the UX point of view?



Sorry for the delay in replying. I was going to reply the next morning, but then I forgot as I was quite sleepy!

We do have a page https://nyxt.atlas.engineer/documentation that basically lists the information. We used to retain that link, but found it unnecessary since now documentation is all built-in.

As Nyxt is quite young, it is still rapidly changing between releases (this does include the UX (as you've mentioned)).

For this reason we would need to provide versioned documentation. Perhaps we can generate versioned documentation from our CI. I will look into it. Thank you for brainstorming with me :-)




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

Search: