docs/registering-users.md recommends matrix-registration, poorly maintained component

[luixxiul]

Describe the bug

docs/registering-users.md says:

If you'd rather **keep your server private** (public registration closed, as is the default), and **let certain people create accounts by themselves** (instead of creating user accounts manually like this), consider installing and making use of [matrix-registration](configuring-playbook-matrix-registration.md).

But docs/configuring-playbook-matrix-registration.md says:

**WARNING**: this is a poorly maintained and buggy project. It's better to avoid using it.

It is confusing that matrix-registration is recommended on one page and not on another.

To Reproduce
Irrelevant

Expected behavior
matrix-registration should not be recommended on registering-users.md. Another component should be recommended instead.

Matrix Server:
Irrelevant

Ansible:
Irrelevant

Client:
Irrelevant

Additional context

[luixxiul]

I think matrix-registration-bot (not matrix-registration) should able to be suggested here instead.

[aine-etke]

matrix-registration-bot does not fully replace matrix-registration. The missing functionality is a web page where users can register on their own (matrix-registration has it, but -bot doesn't).

-bot works using matrix native invite tokens, i.e. it's an alternative to synapse-admin's token management in that case, not to the custom tokens (and custom web page) of matrix-registration.

So, the better approach will be mention synapse admin and matrix-registration-bot in that section, with link to matrix native invite tokens in the spec

[luixxiul]

Thanks. I am not perfectly confident that I could understand that well, so I would like to defer the task to address the issue to another contributor.

[spantaleev]

I'd say matrix-registration is poorly maintained (and newer versions are not packaged in a way that can be made use of), but it's still the best we have now.

I've never personally used the registration bot.