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

Why doesn't Nyxt have online documentation? I can only see an unstructured list of Articles, but no proper manual. Nyxt has some docs embedded in it, but it'd be nice to have it online, so users can read it from the comfort of the browser they've been using for years, playing with Nyxt in a window side-by-side.

And only after reading this paragraph at the _bottom_ of README.org on Github [1] I could find help in Nyxt:

> For full documentation about Nyxt, how it works, and how to extend it please see the embedded help. To get started, run the help command (C-space help).

Could you make it more obviuos? It would be great to have the tutorial [2] and the manual [3] in a readable form on your site.

[1] https://github.com/atlas-engineer/nyxt#documentation--custom...

[2] https://github.com/atlas-engineer/nyxt/blob/master/source/tu...

[3] https://github.com/atlas-engineer/nyxt/blob/master/source/ma...


That's a really good question, thank you for asking. The reason we why we've so far opted to not include documentation online (we used to have it online) was because it would drift from different versions people were using. Lots of times people would see a feature or something in the manual, and wonder why it didn't work on their own installation!

If you have any suggestions as to how to remedy this, or if you think the trade-off is not worth it, we are all ears!


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 :-)


How about a social login and storing preferred version and some sane defaults without login?


Probably not as powerful as TabFS, but there's also https://github.com/balta2ar/brotab:

> bt (brotab = Browser Tabs) is a command-line tool that helps you manage browser tabs. It can help you list, close, reorder, open and activate your tabs.

It supports both Chrome and Firefox. I use it to get titles of tabs that make some sound in Firefox.


"This is the corrected version of the one I put out a month or so ago, in which my animation for all the inverse operations was incorrect": https://www.youtube.com/watch?v=sULa9Lc4pck.


For recording it's much better to speak slowly. You can always speed up slow speech, but doing the opposite (slowing down fast speech) does not bring you a good result yet.


Reading PDFs on Kindle Paperwhite is much more comfortable with KOReader. Thanks to https://www.willus.com/k2pdfopt/ it can crop pages and reflow text unlike the native reader. It's not the best experience with some types of documents, but generally it works very well.

I don't have a solution for synchronization at this point. My current workflow is quite involved: import a document into Calibre, upload it to Kindle via Calibre wireless connection (KOReader supports it), read and highlight, get the modified doc back to Calibre, extract highlights with https://github.com/0xabu/pdfannots. It'd be more convenient to send new highlights from Kindle somewhere immediately without transferring the document itself. I haven't looked into it, but I believe it should be possible with a KOReader plugin.


Koreader is a great program! It works on touchscreen Linux devices as well.

You might be interested in replacing your paperwhite with a "boox" or "likebook" ereader device. Both of these run Android, so in addition to koreader you can install e.g. syncthing and have a shared directory copied between all of your devices and your own PC.


This amazing course is not about using database systems, but about making them.


Maybe the link to [1] would be more interesting.

[1] https://en.wikipedia.org/wiki/List_of_numeral_systems


> if I yank it yanks the visual line, but I expect it to do all

I'm not sure what's the problem with yanking, but probably you want the behavior of kill-whole-line bound to C-M-backspace by default.

https://www.gnu.org/software/emacs/manual/html_node/emacs/Ki...


There's a lecture on Out-of-Order execution [1] in the Design of Digital Circuits course [2].

[1] http://www.youtube.com/watch?v=-ALyN0-jBrw

[2] https://safari.ethz.ch/digitaltechnik/spring2019/doku.php?id...


I suppose you know it, but Firefox on Android supports add-ons! It's amazing.


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

Search: