revite icon indicating copy to clipboard operation
revite copied to clipboard

[Feature Request] How to invite users to a server and request for documentation

Open omegarunner1 opened this issue 3 years ago • 3 comments

What do you want to see?

There are two specific issues that I need resolved now for my current purposes. The first, and more pressing, is to know how to invite people to my server. I created an invite link but it's little more than hash code as far as I can tell. And given that many of the people I'll attempt to invite are not technologically savvy, I would like to know what they're supposed to do with the code so I can guide them myself.

A more long term thing I'd like resolved is a proper document people can read so that they have something look up in the event a really basic problem like this doesn't occur anymore. This is something I find a lot with github projects, where the developers assume things about the software usage are obvious when they're not. A proper document just telling us what a random string of characters is supposed to do, be used for, or represent, is one such thing a document could resolve. And if you keep one on hand you can just keep adding to it.

Commit hash

a816450 (master) Nightly 0.5.3-1 API: 0.5.3-alpha.16 revolt.js: 5.2.7

Branch

Nightly (nightly.revolt.chat)

PWA

  • [ ] Yes, this feature request is specific to the PWA.

omegarunner1 avatar Jan 26 '22 21:01 omegarunner1

Hey! Thanks for the feedback - a few notes:

  • You can accept invites by appending https://rvlt.gg/ with the code. You should also be given an invite link if you click the "Copy Link" button when creating an invite. We're currently working on letting users use invite codes in-app - see #475 for more info.
  • If you post an invite link in-app, it will embed (similar to Discord) which lets those in the same channel join with one click.
  • Little tip: until the modal is added, I would recommend posting invite links in your Saved Notes and joining from there.

As for docs, I wholeheartedly agree - I'm currently working on a revolt.js guide which will hopefully make bot development easier, but afterwards, I would be willing to work on some docs explaining how exactly everything works (albeit possibly not on https://developers.revolt.chat, the current (and to my knowledge only) docs site which (as the URL implies) is mainly focused on developers (although it does have a few non-dev articles, including a Markdown reference guide)).

Hope that helps - if you have any further questions or want to talk to us about anything, feel free to join the Revolt Lounge.

Rexogamer avatar Jan 26 '22 21:01 Rexogamer

Okay, so first, I appreciate how professional and courteous you were with your response. That goes a lot further than you think, especially since the number of groups that can't handle feedback is greater than one would realize.

So some feedback on your suggestions: the append code of https://rvlt.gg/{server code} worked for the person I invited. However, choosing to click on copy link and pasting it to her resulted in her just getting into a loop of needing to login and being booted to the home page without the invite actually accepting.

I haven't attempted to post an invite link in-app but if I ever attempt to do so, I'll let you know.

Finally, on the docs situation, basic server usage would be good to have in a document somewhere, however, if you're more comfortable keeping that for devs and having basic function usage elsewhere, I'll recommend putting that in, at the very least, the readme on the github page. That way, at least those of us that are new to this can have an easy place to consult without needing to get into the nitty gritty of the code if we really don't need to. But I got everything I was looking for so I've got no complaints.

So thank you, with regards.

omegarunner1 avatar Jan 27 '22 04:01 omegarunner1

Apologies for the delayed response - I've been slightly busy, and it's taken some time to find a proper answer for your last question.


Okay, so first, I appreciate how professional and courteous you were with your response. That goes a lot further than you think, especially since the number of groups that can't handle feedback is greater than one would realize.

Of course! We're more than happy to help, and feedback like this is really useful.

Regarding the Copy Link button, I think the issues your friend might be experiencing might be due to the fact that the button currently provides you with an https://(app|nightly).revolt.chat/invite/ link as opposed to a rvlt.gg link - if she had to log in, then she would've been redirected to the home page. The fact she got caught in a loop, however, is slightly concerning - on her second attempt it should just invite her to the server? Further investigation may be needed there.

As for documentation, we'll soon be launching a knowledge base that will house user-focused docs (including the Markdown reference). This knowledge base will also house tutorials, and we'll make sure to write some about joining, creating and using servers.

Thanks again for your detailed and helpful feedback - if you have any other suggestions or questions, please feel free to ask us in the Revolt Lounge ^^

Rexogamer avatar Jun 16 '22 22:06 Rexogamer

Closing due to rewrite, marking as potential issue in future by linking to https://github.com/revoltchat/frontend/issues/134.

insertish avatar Jan 24 '23 16:01 insertish