mattermost / mattermost/mattermost-developer-documentation

Help Wanted: Default parameters are not correctly rendered in plugin registry methods

Open
#627 15 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

difficulty/2:Medium Help Wanted Type/Bug Up For Grabs
Dominant language
CSS
Stars
90
Forks
460
Avg merge
9d 23h
Merged PRs (30d)
2

Description

See, for example, registerAdminConsoleCustomSetting, where showTitle is missing:

image

This happens because the default parameters have a different structure in the AST returned by the parser.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start from the documentation page for registerAdminConsoleCustomSetting and trace the parser or renderer that produces the plugin registry method reference. Compare how ordinary and default parameters are represented in the AST, using the missing showTitle example as the reproduction. Done means default parameters appear correctly in the generated reference.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.