Paid plugins: will current documentation template remain?

Corona Marketplace Corona Community Plugins
#1

With the upcoming Paid Plugins feature in the Corona Store, will this documentation process remain:

https://github.com/coronalabs/plugins-template-library-docs

I’d like to publish plugins as soon as this feature becomes available and I’d like to prepare my docs.

  • Tyr
#2

Yes that documentation is up to date. That said, many community plugin providers offer documentation from their own web servers.

Rob

#3

That means those templates are not a *most* to follow but rather a recommendation?

#4

That’s a hard question to answer. We provided the templates so you could use GitHub as an easy way to deploy documentation without you having to maintain your own website and write your own HTML. GitHub uses markdown so if you are going to use GitHub it should be written in markdown.

As for the templates themselves, you have to have a minimum level of documentation and the closer you adhere to the template the better it will be. The templates are designed based on our own documentation standards. But regardless all the information needs to be provided.

You have to have an:

  • Overview – Let people know what it’s about along with any gotchas, minimum requirements etc.
  • Configuration – How do people need to include it in build.settings? What permissions do they need to add, etc?
  • List of all API calls and any values. Each of these needs their own separate entry.
  • Samples – show people how to use it.
  • Contact info 
  • valid platforms for the plugin.

The closer you can match what we list the better it will be.  Consider it a minimum requirements but you don’t have to use github and markdown.

Rob