Issue #16426 has been updated by Nigel Kersten.

We've had intro chats with Mashery and Apigee (who are Puppet users...) about 
their services as far as publishing APIs go.

Happy to set up conversations if anyone involved in this is interested.  There 
are some nice benefits to a more interactive set of API docs that can be 
awesome for development.
----------------------------------------
Feature #16426: Publish API documentation automatically
https://projects.puppetlabs.com/issues/16426#change-71149

Author: Andrew  Parker
Status: Unreviewed
Priority: Normal
Assignee: 
Category: API
Target version: 
Affected Puppet version: 
Keywords: documentation, docs, yard, API
Branch: 


At the moment there is no generated documentation that we automatically 
publish. This limits our ability to document and publish the public API for 
using puppet as a library or accessing supported features when writing 
extensions. There have been some attempts in the past to generate YARD docs and 
publish them to github as gh-pages, but that effort bit-rotted. We need to come 
up with a way of creating and maintaining these kinds of docs.


-- 
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to