Skip to content

(PDOC-295) Add @enum tag support for Enum data types #215

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

Merged
merged 1 commit into from
Nov 1, 2019

Conversation

seanmil
Copy link
Contributor

@seanmil seanmil commented Oct 20, 2019

Enum data types would benefit from the ability to add extended
documentation on each option similarly to the @option tag
for hashes. The @option type is not a good fit for Enum data
type parameters as it requires data types to be specified,
which doesn't make sense in the context of an Enum type.

This patch adds a new @enum tag which behaves like @option,
but does not accept the data type parameter that @option does.

@seanmil seanmil force-pushed the add_enum_tag branch 2 times, most recently from dab6101 to 8e5ffe1 Compare October 20, 2019 14:07
@seanmil seanmil changed the title Add 'enum' tag support for Enum data types (PDOC-295) Add @enum tag support for Enum data types Oct 20, 2019
@scotje
Copy link
Contributor

scotje commented Oct 29, 2019

I think the acceptance test failure is due to a PDK "missing require" bug that should be fixed with the new PDK release this week. After that I'm 👍 to merge this.

@scotje
Copy link
Contributor

scotje commented Nov 1, 2019

Re-kicking CI now that PDK 1.14.1 gem has been released.

@scotje
Copy link
Contributor

scotje commented Nov 1, 2019

Fresh new failures now, hoping #217 will resolve

Enum data types would benefit from the ability to add extended
documentation on each option similarly to the '@option' tag
for hashes. The option type is not a good fit for Enum data
type parameters as it requires data types to be specified,
which doesn't make sense in the context of a Enum type.
@scotje
Copy link
Contributor

scotje commented Nov 1, 2019

Rebased on top of #217.

@scotje
Copy link
Contributor

scotje commented Nov 1, 2019

Hooray, CI passing now!

@scotje scotje merged commit 7eae230 into puppetlabs:master Nov 1, 2019
@eputnam eputnam added the feature label Feb 5, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants