Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Avoid generating documentation of an optional body parameters #894

Open
1 task done
nnbai opened this issue Sep 25, 2024 · 1 comment
Open
1 task done

Avoid generating documentation of an optional body parameters #894

nnbai opened this issue Sep 25, 2024 · 1 comment
Labels
question Further information is requested

Comments

@nnbai
Copy link

nnbai commented Sep 25, 2024

Scribe version

4.32.0

Your question

One of the APIs has a parameter (body parameter) in a form request that is only used for internal purposes. However, it is part of form validation and is an optional parameter. Scribe is used for generating the documentation for external parties.

How do I avoid generating documentation for this parameter?

Docs

@nnbai nnbai added question Further information is requested triage labels Sep 25, 2024
@shalvah shalvah removed the triage label Nov 5, 2024
@shalvah
Copy link
Contributor

shalvah commented Nov 5, 2024

Hmm, you don't want it to show at all in the docs? We could maybe add support for a hidden comment. But, in the meantime, your best bet would be to create a custom strategy. Make sure it runs last, and I think you should be able to unset the parameter from the ExtractedEndpointData object.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
question Further information is requested
Projects
None yet
Development

No branches or pull requests

2 participants