An additional thing we need to add to the todo list: theme/package instructions. You've got the API but not instructions on installing/using.

@McInkay, thanks for checking out! :)
I did add something actually, in the Usage section: https://deploy-preview-84--thelounge-chat.netlify.com/docs/usage#installing-additional-themes

At the moment, it's only about themes because there are no packages out there at all, but as soon as https://www.npmjs.com/search?q=keywords%3Athelounge-package has a single package, I'll update the section to be about both themes and packages :)
Chicken and egg situation, because it could also be confusing to tell users how to install packages when there is not a single one.
I am confident you will be publishing the very first package, so I'm happy to work on the doc if you do so!

I have a number of packages ready to be published once my PRs are merged :-P so yeah, that's fine leaving it as just themes just now, I get that.

However, I'm wondering whether that's obvious enough or not. Maybe it is.

It should be noted in install docs that since Yarn installs into user folder by default, the binary isn't going to be available in $PATH.

On linux the fix is to add Yarn global path to your $PATH like export PATH="$PATH:$(yarn global bin)"

EDIT: Actually it is mentioned, but that one liner is probably preferable to be included as well.

@xPaw, I'd rather not do this because it's very platform-dependent. For example, on macOS (though I know server install is rarely on macOS, but still, we do advertise it as cross-OS :D), it's available by default if you install with Homebrew.

You probably remember, but long time ago (ahem) we were documenting how to install Node on Ubuntu, Mac, and Windows, then we had to add CentOS/Fedora/RHEL, at which point we decided to redirect to Node's comprehensive package manager install document (as it is on the current doc). The Yarn install page is actually really good, lets you pick your OS and gives instructions accordingly, so I think I'd rather send reader to this page early in the install section, similarly to what we do with Node. You'd be okay with that?

You're right their install is pretty good. I just think we can make the npm install section a little easier to follow. For example we don't link to that page on how to install Yarn.

Yep, that's what I meant, adding a link to this page and making it all a bit better. Will do!

Closing this PR now. Everything has been moved to other PRs/issues and in most cases merged. Only leftovers of this PR are things that do not need to be merged.