Hello! I would love to help with the type defs/jsdocs if I get time. In the meantime, this is what I’m seeing:
There seems to be no description of it here:
I don’t want to look at the actual source code for documentation, also there are no JSDoc comments on this API, as hovering shows only a type definition:
Asking AIs how to do things like “enable email verification” leads to suggestions like using Accounts.config() for which there is not a single doc.
If the AI suggests undocumented APIs as a standard way of doing things, this is a problem!
Can someone please update that doc to make it obvious how to set up email verification, etc?
There’s no search result in the docs for forbidClientAccountCreation, for example, yet it shows up in the type definition.
After the 3.0 docs migration, and the removal of Meteor’s own docs AI (wat is too expensive?), I feel that docs have gotten harder to understand than before.
It seems, but is not entirely obvious (without looking at source code) that Meteor.settings.packages.accounts is the way to set Accounts.config() alternatively. However, Meteor.settings.packages.accounts is untyped, all the keys are unknown.
It is also not obvious in the docs that Accounts is an instance of AccountsCommon, without looking at source, and the type definition says that Accounts is a namespace which isn’t technically true. Basically it’s not obvious what is going on from type defs or the docs.
The Accounts object can be typed as AccountsCommon at least, which would then, for TypeScript users at least, make it obvious that the accountsCommon in the docs is the same thing.
The docs suggest this,
const accountsCommon = new AccountsCommon(
options
);
which I’m fairly sure is not what most people want to do. They want to configure the global instance that already exists, so this is a little misleading, and it isn’t clear that manual instantiation is for specialized use cases that are not the default.
EDIT: Although search results did not show anything for forbidClientAccountCreation/etc, expanding the section under accountsCommon.config did reveal the option.
Is there a way to fix the Algolia search feature so it is not omitting content?
EDIT: I’m not sure if this is a bug, or I’m just not understanding when/how to set Accounts config:
