From 977b9c282d5361dfe615e042935ee56ab0dfe6a2 Mon Sep 17 00:00:00 2001 From: Bruno Windels Date: Mon, 25 Jan 2021 10:35:13 +0100 Subject: [PATCH] add FAQ --- README.md | 4 ++++ doc/FAQ.md | 29 +++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+) create mode 100644 doc/FAQ.md diff --git a/README.md b/README.md index 54d0a563..e4a36993 100644 --- a/README.md +++ b/README.md @@ -15,3 +15,7 @@ If you find this interesting, come and discuss on `#hydrogen:matrix.org`. # How to use Hydrogen is deployed to [hydrogen.element.io](https://hydrogen.element.io). You can run it locally `yarn install` (only the first time) and `yarn start` in the terminal, and point your browser to `http://localhost:3000`. + +# FAQ + +Some frequently asked questions are anwsered [here](doc/FAQ.md). diff --git a/doc/FAQ.md b/doc/FAQ.md new file mode 100644 index 00000000..ceb9666c --- /dev/null +++ b/doc/FAQ.md @@ -0,0 +1,29 @@ +# FAQ + +### Is feature X supported? + +If you can't find an easy way to locate the feature you are looking for, then the anwser is usually "no, not yet" :) But here are some things people have asked about in the past? + +### How does newline work? Shift+Enter has no effect. + +That's not yet a feature, as hydrogen just uses a single line text box for message input for now. + +### Hmm does Hydrogen not support leaving rooms? I left some rooms via Element and they moved to "Historical" but nothing happened on this end. + +Indeed :) Joining and leaving isn't implemented yet, just haven't gotten around to it. + +## Is there a way to run the app as a desktop app? + +You can install Hydrogen as a PWA using Chrome/Chromium on any platform or Edge on Windows. There is no Electron build of Hydrogen. + +## How can I verify my session from Element? + +You can only verify by comparing keys manually currently. In Element, go to your own profile in the right panel, click on the Hydrogen device and select Manually Verify by Text. The session key displayed should be the same as in the Hydrogen settings. You can't yet mark your Element session as trusted from Hydrogen. + +## I want to host my own Hydrogen, how do I do that? + +There are no published builds at this point. You need to checkout the version you want to build, or master if you want to run bleeding edge, and run `yarn init` and then `yarn build` in a console (and install nodejs > 14 and yarn if you haven't yet). Now you should find all the files needed to host Hydrogen in the `target/` folder, just copy them all over to your server. As always, don't host your client on the same [origin](https://web.dev/same-origin-policy/#what's-considered-same-origin) as your homeserver. + +## I want to embed Hydrogen in my website, how should I do that? + +There are no npm modules yet published for Hydrogen. The easiest is probably to setup your website project, do yarn init if you haven't yet, add, the hydrogen repo as a git dependency, and import the files/classes you want to use from Hydrogen. Feel free to ask which classes you need as the documentation is lacking somewhat still. Note that at this early, pre 1.0 stage of the project, there is no promise of API stability yet.