RocketChat / Rocket.Chat

The communications platform that puts data protection first.
https://rocket.chat/
Other
40.45k stars 10.53k forks source link

Missing descriptions of Administration menu options and their settings #20996

Open OKNoah opened 3 years ago

OKNoah commented 3 years ago

Description:

There is almost no information describing what some admin settings do, but the ability to have descriptions clearly exists and is demonstrated on some areas within Administration. The options and fields that exist seem so improperly named that I can't find information about through search engines. And when it comes to 3rd party integrations, sometimes can't find the wanted details anywhere in the UI.

Steps to reproduce:

  1. Go to Administration
  2. Visit the following sections and observe what is noted on:

The Administration area needs serious work. There is not description at all on what most settings do. They ask for user input values that often I can't even find with a search engine. The help menu doesn't seem to contain help with these either.

Some examples (of bad settings menus):

Expected behavior:

Some examples of better settings menus:

Actual behavior:

See Steps to reproduce.

Server Setup Information:

Client Setup Information

OKNoah commented 3 years ago

So, before installing Jitsi on my server, I tried "8x8" Jitsi SaaS. There is no mention of an application secret, required in the settings. Does it mean the private key key that can be downloaded? What about the URL, 8x8.vc? Room prefix, suffix?

Moreover, user avatars don't work despite some uploaded files working with the S3-compatible bucket.

Given that Rocket.Chat still uses SaaS services out of the box (the push notifications, etc), I thought there would be more motivation to have basic setup help like this.

micksharma commented 3 years ago

I want to work on this bug.

micksharma commented 3 years ago

@OKNoah in client Setup information side I am on windows ? Can I work on this issue.

OKNoah commented 3 years ago

@micksharma This is in Administration. I'm on macOS.