svandecappelle / jQPlot

JQplot revival
http://svandecappelle.github.io/jQPlot/
MIT License
29 stars 13 forks source link

Do a complete documentation of all possible options for each plugins #10

Open svandecappelle opened 9 years ago

roycebautista commented 9 years ago

Hello, I want to use your version of jQPlot since it is the most actively developed (The original jqPlot has its last commit 2 years ago). however, with the many commits that you have made I am now wondering. Does the documentation on the old jqplot is still applicable to your version of jQPlot?

svandecappelle commented 9 years ago

Yes it is still applicable, I just added some options and features. But all the original existing options are still applicable.

roycebautista commented 9 years ago

Ok thanks, I'll be using this :)

johanbove commented 9 years ago

Would this be a migration of the existing documentation over on the website? @svandecappelle Do you have an overview of the additions you added?

svandecappelle commented 9 years ago

@johanbove There is no documentation page that show the additions from the original sources.

But: This is essentially bug fixes.

Modifications affects essentially:

In the documentation i will highlight the new features.

RubenOlsen commented 9 years ago

I'll start the work on generating API docs based on the current sources. Ref the mails on the list - the generated API documentation will be available in the GH-pages.

I think the first thing that needs to be documented is the API, secondly the examples.

svandecappelle commented 9 years ago

I Have not yet worked on API documentation generation. It looks cool to use jekyll for atuomatic generation. The site is not generated. I all write it by hand. But the API documentation could be generated.

I wanted the site contains:

RubenOlsen commented 9 years ago

Very good.

I'll keep the structure and everything. It's a good structure for what we need with regards to our documentation.

Jekyll is not used for generating the API documentation - jsdoc (http://usejsdoc.org/) is a good choice.

Jekyll is a good website builder which uses templates and stuff. This means that if we decide to add a new menu-choice, or change the content of the ... sections, etc - this will be automatically changed on all webpages without having to do any global search&replace. Using a tool like jekyll means that we'll never forget to add "common stuff" to new pages.

I'll do a pull-request on the gh-pages branch some time during this weekend.

Could you also change my status in the project so that i can assign tickets to myself?

johanbove commented 9 years ago

:+1: Thanks for the commitment Ruben!