Issue #6962 has been updated by Charlie Sharpsteen.

Keywords set to  customer

----------------------------------------
Feature #6962: self-documenting strings, actions, and options
https://projects.puppetlabs.com/issues/6962#change-88681

* Author: Daniel Pittman
* Status: Closed
* Priority: Normal
* Assignee: Nick Fagerlund
* Category: Faces
* Target version: 2.7.0
* Affected Puppet version: development
* Keywords:  customer
* Branch: https://github.com/nfagerlund/puppet/tree/ticket/2.7.x/6962
----------------------------------------
We want to have strings, actions, and options as self-documenting as possible.

This requires:

 * We can declare the documentation inline when creating the various objects in 
the system.
 * We can introspect the various bits and extract that documentation.
 * We expose this through a 'help' string that returns the structured data to 
allow generic renderings of that information.  (eg: to a string for user 
presentation, or HTML, or whatever else we want based on the outside interface.)
 * We need to implement generic CLI interface that uses the help string to 
render the help to a string and present that to the user.
 * We need to implement a global option `--help` for all CLI strings that 
redirects from the requested string to the help string, and presents help to 
the user for the string they requested.



-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/puppet-bugs?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to