Hi Serge, I pushed a PR (WIP) for the asciidoc documentation, the html generation is ok.
I'm checking now for the pdf generation. regards, François Papon [email protected] Le 27/08/2018 à 13:52, Francois Papon a écrit : > Hi Serge, > > Thanks ;) > > I fixed the Beam reference and for the documentation part, I will work > on it this week and make a proposal. > > I'm agree, it would be great to put the new site online soon :) > > regards, > > François Papon > [email protected] > > Le 27/08/2018 à 12:55, Serge Huber a écrit : >> Hello François, >> >> Very nice work, I like all the new contribution content! >> >> The release guide will probably have to be merged with my current >> notes that I am maintaining here, but we could do that at a later >> stage: >> https://docs.google.com/document/d/1H6d8AkavL0K8rlAEd7jHqDRAaq6MeaES54RXTHt805o/edit?usp=sharing >> >> I found a remaining Beam reference here: >> Tardis:incubator-unomi-website loom$ grep -R -i beam * >> src/main/webapp/contribute-pre-commit-test-policies.html: >> <li>A PR must pass pre-commit tests before being committed to the main >> Beam repo. >> >> But amazing work and thanks for that. I am thinking we could put this >> online soon, we just need to figure out how to handle the >> documentation part ? >> >> cheers, >> Serge... >> On Sat, Aug 25, 2018 at 6:32 PM Francois Papon >> <[email protected]> wrote: >>> Hi, >>> >>> I made some changes on the website : >>> >>> * add content in the "contribute" page >>> * add content in the "community" page >>> * clean up the footer menu >>> >>> Some page may be complete/fix like the "release guide", I'm not sure of >>> all the step for this section... >>> >>> regards, >>> >>> François Papon >>> [email protected] >>> >>> Le 24/08/2018 à 15:06, Serge Huber a écrit : >>>> Yes that's what I meant a new website subproject :) >>>> >>>> cheers, >>>> Serge... >>>> >>>> On Fri, Aug 24, 2018 at 12:22 PM Francois Papon >>>> <[email protected]> wrote: >>>>> Great for the graduation, I will copy :) >>>>> >>>>> For the PR I think it's better to add a new wsebsite sub-projetct. >>>>> >>>>> regards, >>>>> >>>>> François Papon >>>>> [email protected] >>>>> >>>>> Le 24/08/2018 à 14:16, Serge Huber a écrit : >>>>>> Just to be clear Apache Beam recently had to go through all the >>>>>> graduation requirements so that's why I'm suggesting their site as a >>>>>> template. As it is all Apache licensed content we can copy it without >>>>>> any problem :) >>>>>> >>>>>> For the PR that seems fine, should we add a new website sub-project? >>>>>> >>>>>> cheers, >>>>>> Serge... >>>>>> On Fri, Aug 24, 2018 at 10:58 AM francois.papon >>>>>> <[email protected]> wrote: >>>>>>> Hi Serge, >>>>>>> Ok for the graduation requirements, I will add the content. >>>>>>> For the source repository, I think it would be great to put it on Git. >>>>>>> I will easily push a PR ;) >>>>>>> Regards, >>>>>>> >>>>>>> >>>>>>> Envoyé depuis mon smartphone Samsung Galaxy. >>>>>>> -------- Message d'origine --------De : Serge Huber <[email protected]> >>>>>>> Date : 24/08/2018 11:50 (GMT+04:00) À : >>>>>>> [email protected] Objet : Re: [PROPOSAL] - Website and >>>>>>> documentation >>>>>>> Hello François, >>>>>>> >>>>>>> Thanks for all the changes, I really like them. >>>>>>> >>>>>>> For the graduation requirements, we have a maturity report here: >>>>>>> http://unomi.apache.org/maturity-model-report.html >>>>>>> >>>>>>> You will see that most of the content needed is for example available >>>>>>> on the Apache Beam website in the URLs I sent in my previous message >>>>>>> in this thread (for example how to handle security issues). >>>>>>> >>>>>>> Also I had a question about where we would put the new website ? Would >>>>>>> we directly host it in the Subversion or would we put it somewhere in >>>>>>> the Git repository ? >>>>>>> >>>>>>> Regards, >>>>>>> Serge... >>>>>>> >>>>>>> ps: the 1.3.0 release was just approved, I need to put it on the >>>>>>> website today :) >>>>>>> >>>>>>> On Fri, Aug 24, 2018 at 4:15 AM Francois Papon >>>>>>> <[email protected]> wrote: >>>>>>>> Hi, >>>>>>>> >>>>>>>> I made some change on the website after have a look to the Apache Beam >>>>>>>> website : >>>>>>>> >>>>>>>> - update the home page header >>>>>>>> >>>>>>>> - remove news page, may be not necessary because we already have a >>>>>>>> section news on the home page >>>>>>>> >>>>>>>> - add a "get started" page for the newcomers, I will write some section >>>>>>>> for how to a new user can install and start using Apache Unomi. We >>>>>>>> could >>>>>>>> add some examples for how to use after install. >>>>>>>> >>>>>>>> - add a "contribute" page (need to be complete) >>>>>>>> >>>>>>>> - update the "community" page >>>>>>>> >>>>>>>> Their is a lot of content in the Apache Beam website and have to see >>>>>>>> what we have to keep to be compliant for the graduation : where can I >>>>>>>> find the informations about the graduation requirements ? >>>>>>>> >>>>>>>> regards, >>>>>>>> >>>>>>>> François Papon >>>>>>>> [email protected] >>>>>>>> >>>>>>>> Le 23/08/2018 à 18:48, francois.papon a écrit : >>>>>>>>> Ok, I will take a look on the Beam website and see how to use it as >>>>>>>>> inspiration :) >>>>>>>>> regards, >>>>>>>>> François >>>>>>>>> >>>>>>>>> >>>>>>>>> Envoyé depuis mon smartphone Samsung Galaxy. >>>>>>>>> -------- Message d'origine --------De : Serge Huber >>>>>>>>> <[email protected]> Date : 23/08/2018 18:26 (GMT+04:00) À : >>>>>>>>> [email protected] Objet : Re: [PROPOSAL] - Website and >>>>>>>>> documentation >>>>>>>>> Looks much better thanks! And I tested in a mobile format it works >>>>>>>>> except for the bottom footer that looks a bit garbled (see attached >>>>>>>>> image). Btw I'm using Safari's Responsive Design mode to test this (in >>>>>>>>> the develop menu). >>>>>>>>> >>>>>>>>> For the main documentation is the idea (still) to copy this over at a >>>>>>>>> later stage? >>>>>>>>> >>>>>>>>> Thanks again for all the work. >>>>>>>>> >>>>>>>>> We will also need to add more contribution pages to be compliant with >>>>>>>>> the requirements for graduation, for example, we should copy the >>>>>>>>> contents of the beam site for these pages: >>>>>>>>> https://beam.apache.org/contribute/ and >>>>>>>>> https://beam.apache.org/community/contact-us/ >>>>>>>>> >>>>>>>>> Btw, in general, I really like the Apache Beam site. Maybe we could >>>>>>>>> use it as inspiration? >>>>>>>>> >>>>>>>>> Serge Huber >>>>>>>>> CTO & Co-Founder >>>>>>>>> >>>>>>>>> T +41 22 361 3424 >>>>>>>>> 9 route des Jeunes | 1227 Acacias | Switzerland >>>>>>>>> jahia.com >>>>>>>>> SKYPE | LINKEDIN | TWITTER | VCARD >>>>>>>>> >>>>>>>>> >>>>>>>>>> JOIN OUR COMMUNITY to evaluate, get trained and to discover why >>>>>>>>>> Jahia is a leading User Experience Platform (UXP) for Digital >>>>>>>>>> Transformation. >>>>>>>>> On Thu, Aug 23, 2018 at 2:55 PM Francois Papon >>>>>>>>> <[email protected]> wrote: >>>>>>>>>> Hi, >>>>>>>>>> >>>>>>>>>> I pushed an update for the mobile responsive menu and I reduced the >>>>>>>>>> font-size and space. >>>>>>>>>> >>>>>>>>>> regards, >>>>>>>>>> >>>>>>>>>> François Papon >>>>>>>>>> [email protected] >>>>>>>>>> >>>>>>>>>> Le 23/08/2018 à 08:50, Francois Papon a écrit : >>>>>>>>>>> Hi Serge, >>>>>>>>>>> >>>>>>>>>>> Thanks for your feedback ! >>>>>>>>>>> >>>>>>>>>>> For the maven pom, we use it in Karaf to deploy via scm, I can >>>>>>>>>>> remove it >>>>>>>>>>> if no needs. >>>>>>>>>>> >>>>>>>>>>> For the getting start part, I put the 5 minutes quick start on the >>>>>>>>>>> main >>>>>>>>>>> page, if you are talking about part in the main documentation, it's >>>>>>>>>>> normal but I can add it. >>>>>>>>>>> >>>>>>>>>>> I will down the font size and reduce some space as you say. >>>>>>>>>>> >>>>>>>>>>> The CSS is Bootstrap 4, I will check for the menu on mobile (it work >>>>>>>>>>> well on Karaf website and I just forked the site). >>>>>>>>>>> >>>>>>>>>>> I tried to update quickly ;) >>>>>>>>>>> >>>>>>>>>>> It's a good idea the have animation or video, and we also have some >>>>>>>>>>> highlight on the caroussel at the top of the main page. The "use >>>>>>>>>>> cases" >>>>>>>>>>> page can also have some additional content to explain how users can >>>>>>>>>>> integrate Unomi in their legacy system easily. >>>>>>>>>>> >>>>>>>>>>> regards, >>>>>>>>>>> >>>>>>>>>>> François Papon >>>>>>>>>>> [email protected] >>>>>>>>>>> >>>>>>>>>>> Le 22/08/2018 à 23:19, Serge Huber a écrit : >>>>>>>>>>>> Hi François, >>>>>>>>>>>> >>>>>>>>>>>> Thanks for your work. I tried to compile the project but I got the >>>>>>>>>>>> following error : >>>>>>>>>>>> >>>>>>>>>>>> [INFO] Scanning for projects... >>>>>>>>>>>> [ERROR] [ERROR] Some problems were encountered while processing >>>>>>>>>>>> the POMs: >>>>>>>>>>>> [FATAL] 'version' is missing. @ line 23, column 106 >>>>>>>>>>>> @ >>>>>>>>>>>> [ERROR] The build could not read 1 project -> [Help 1] >>>>>>>>>>>> [ERROR] >>>>>>>>>>>> [ERROR] The project org.apache.unomi:site:[unknown-version] >>>>>>>>>>>> (/Users/loom/temp/incubator-unomi-website/pom.xml) has 1 error >>>>>>>>>>>> [ERROR] 'version' is missing. @ line 23, column 106 >>>>>>>>>>>> [ERROR] >>>>>>>>>>>> [ERROR] To see the full stack trace of the errors, re-run Maven >>>>>>>>>>>> with >>>>>>>>>>>> the -e switch. >>>>>>>>>>>> [ERROR] Re-run Maven using the -X switch to enable full debug >>>>>>>>>>>> logging. >>>>>>>>>>>> [ERROR] >>>>>>>>>>>> [ERROR] For more information about the errors and possible >>>>>>>>>>>> solutions, >>>>>>>>>>>> please read the following articles: >>>>>>>>>>>> [ERROR] [Help 1] >>>>>>>>>>>> http://cwiki.apache.org/confluence/display/MAVEN/ProjectBuildingException >>>>>>>>>>>> >>>>>>>>>>>> After adding a version however it worked fine ! >>>>>>>>>>>> >>>>>>>>>>>> I like the overall result although it seems like it is using a lot >>>>>>>>>>>> of >>>>>>>>>>>> space and some fonts seem really large. Also it seems some stuff is >>>>>>>>>>>> missing like the getting started (I couldn't find it). >>>>>>>>>>>> >>>>>>>>>>>> I like the new documentation part, some nice ideas there. >>>>>>>>>>>> >>>>>>>>>>>> My biggest concern is on-boarding newcomers with the site, and I >>>>>>>>>>>> think >>>>>>>>>>>> they shouldn't have to read through a lot of content to understand >>>>>>>>>>>> what the project does. Ideally maybe we should look into producing >>>>>>>>>>>> some kind of video or a quick animation. >>>>>>>>>>>> >>>>>>>>>>>> Finally I tried the site on a mobile device and it seems the >>>>>>>>>>>> navigation completely disappears. >>>>>>>>>>>> >>>>>>>>>>>> Anyway thanks for the effort I like it ! >>>>>>>>>>>> >>>>>>>>>>>> cheers, >>>>>>>>>>>> Serge... >>>>>>>>>>>> On Wed, Aug 22, 2018 at 12:12 PM Francois Papon >>>>>>>>>>>> <[email protected]> wrote: >>>>>>>>>>>>> Hi, >>>>>>>>>>>>> >>>>>>>>>>>>> I worked on a preview version of the website and published it on >>>>>>>>>>>>> my >>>>>>>>>>>>> github repo : >>>>>>>>>>>>> >>>>>>>>>>>>> https://github.com/fpapon/incubator-unomi-website >>>>>>>>>>>>> >>>>>>>>>>>>> I also started to work on a easy way to publish the documentation >>>>>>>>>>>>> from >>>>>>>>>>>>> markdown to HTML and PDF. >>>>>>>>>>>>> >>>>>>>>>>>>> May be it could be nice to archive the documentation related to >>>>>>>>>>>>> the >>>>>>>>>>>>> maven project with git tag because today it's on differents >>>>>>>>>>>>> folder in >>>>>>>>>>>>> the src/ of the project. >>>>>>>>>>>>> >>>>>>>>>>>>> Thoughts ? >>>>>>>>>>>>> >>>>>>>>>>>>> regards, >>>>>>>>>>>>> >>>>>>>>>>>>> François Papon >>>>>>>>>>>>> [email protected] >>>>>>>>>>>>> >>>>>>>>>>>>> Le 03/08/2018 à 00:14, Serge Huber a écrit : >>>>>>>>>>>>>> Thanks François, looking forward to the PR ! >>>>>>>>>>>>>> >>>>>>>>>>>>>> If you want to work on the website you're more than welcome to >>>>>>>>>>>>>> start >>>>>>>>>>>>>> working on it, as I said the more people get involved the better >>>>>>>>>>>>>> for >>>>>>>>>>>>>> the project ! >>>>>>>>>>>>>> >>>>>>>>>>>>>> Regards, >>>>>>>>>>>>>> Serge.. >>>>>>>>>>>>>> On Wed, Aug 1, 2018 at 8:48 PM Francois Papon >>>>>>>>>>>>>> <[email protected]> wrote: >>>>>>>>>>>>>>> Ok for Swagger, I will post a PR. >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> About the website, let me know when you want me to start >>>>>>>>>>>>>>> working on it >>>>>>>>>>>>>>> (I already have a repo on my github account). >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> regards, >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> François Papon >>>>>>>>>>>>>>> [email protected] >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> Le 01/08/2018 à 18:25, Serge Huber a écrit : >>>>>>>>>>>>>>>> Feel free to help out on Swagger, I have little to no >>>>>>>>>>>>>>>> experience with it. >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> As for the GraphQL side, it's very experimental code that is >>>>>>>>>>>>>>>> constantly changing right now, so be warned that things might >>>>>>>>>>>>>>>> change >>>>>>>>>>>>>>>> quite significantly at any point but feel free to look at it >>>>>>>>>>>>>>>> and give >>>>>>>>>>>>>>>> feedback or even contribute! >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> cheers, >>>>>>>>>>>>>>>> Serge... >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> Serge Huber >>>>>>>>>>>>>>>> CTO & Co-Founder >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> T +41 22 361 3424 >>>>>>>>>>>>>>>> 9 route des Jeunes | 1227 Acacias | Switzerland >>>>>>>>>>>>>>>> jahia.com >>>>>>>>>>>>>>>> SKYPE | LINKEDIN | TWITTER | VCARD >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> JOIN OUR COMMUNITY to evaluate, get trained and to discover >>>>>>>>>>>>>>>>> why Jahia is a leading User Experience Platform (UXP) for >>>>>>>>>>>>>>>>> Digital Transformation. >>>>>>>>>>>>>>>> On Wed, Aug 1, 2018 at 9:00 AM Francois Papon >>>>>>>>>>>>>>>> <[email protected]> wrote: >>>>>>>>>>>>>>>>> Cool, >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> If needed, I can help on the Swagger and the GraphQL >>>>>>>>>>>>>>>>> integration ;) >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> regards, >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> François Papon >>>>>>>>>>>>>>>>> [email protected] >>>>>>>>>>>>>>>>> Yupiik - https://www.yupiik.com >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> Le 31/07/2018 à 23:01, Serge Huber a écrit : >>>>>>>>>>>>>>>>>> Hello François, >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> Thanks for clarifying that I wasn't aware that you could use >>>>>>>>>>>>>>>>>> Swagger >>>>>>>>>>>>>>>>>> that way. That makes sense. >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> For GraphQL yes the final version of the CXS specification >>>>>>>>>>>>>>>>>> I'm also >>>>>>>>>>>>>>>>>> co-developing has switched from REST to GraphQL, and I'm >>>>>>>>>>>>>>>>>> currently >>>>>>>>>>>>>>>>>> implementing that in a branch to validate the design of the >>>>>>>>>>>>>>>>>> GraphQL >>>>>>>>>>>>>>>>>> schema. It's a challenge because we are doing some advanced >>>>>>>>>>>>>>>>>> stuff with >>>>>>>>>>>>>>>>>> GraphQL but the API is already a lot more powerful than the >>>>>>>>>>>>>>>>>> REST API. >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> cheers, >>>>>>>>>>>>>>>>>> Serge... >>>>>>>>>>>>>>>>>> On Tue, Jul 31, 2018 at 6:25 PM Francois Papon >>>>>>>>>>>>>>>>>> <[email protected]> wrote: >>>>>>>>>>>>>>>>>>> Hi Serge, >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> Thanks for your feedback :) >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> I see the Miredot documentation and for me it's good. >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> I propose to add Swagger (not to replace Miredot) to have a >>>>>>>>>>>>>>>>>>> GUI to >>>>>>>>>>>>>>>>>>> simulate request and response for developers. >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> I already used the cxf-swagger-feature in a Karaf project >>>>>>>>>>>>>>>>>>> and the only >>>>>>>>>>>>>>>>>>> bug I found it's the refresh of the json when updating the >>>>>>>>>>>>>>>>>>> bundle in a >>>>>>>>>>>>>>>>>>> started instance. >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> I have in mind to propose a page on the website dedicated >>>>>>>>>>>>>>>>>>> to the API >>>>>>>>>>>>>>>>>>> like this : >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> https://projects.tmforum.org/wiki/display/API/Open+API+Table >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> I saw a JIRA about GraphQL integration, it's great :) >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> regards, >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> François Papon >>>>>>>>>>>>>>>>>>> [email protected] >>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>> Le 31/07/2018 à 19:48, Serge Huber a écrit : >>>>>>>>>>>>>>>>>>>> Hello François, >>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>> Thank you for your proposal, I really like the new design ! >>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>> For me, the user documentation could be reformated to make >>>>>>>>>>>>>>>>>>>> it easier >>>>>>>>>>>>>>>>>>>> to browse and of course, it always needs improving and >>>>>>>>>>>>>>>>>>>> detailing. >>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>> Concerning the REST API documentation, currently, we use >>>>>>>>>>>>>>>>>>>> another tool >>>>>>>>>>>>>>>>>>>> to generate it from the source code, and it is capable of >>>>>>>>>>>>>>>>>>>> documenting >>>>>>>>>>>>>>>>>>>> the JSON structure at the same time. The whole source code >>>>>>>>>>>>>>>>>>>> was >>>>>>>>>>>>>>>>>>>> documented to work with this plugin >>>>>>>>>>>>>>>>>>>> (http://www.miredot.com/) for >>>>>>>>>>>>>>>>>>>> which we got a free license since it is an Apache project. >>>>>>>>>>>>>>>>>>>> Are you >>>>>>>>>>>>>>>>>>>> suggesting we replace this with Swagger (we evaluated it >>>>>>>>>>>>>>>>>>>> at the time >>>>>>>>>>>>>>>>>>>> but it was missing some features for generating from the >>>>>>>>>>>>>>>>>>>> code) ? >>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>> Regards, >>>>>>>>>>>>>>>>>>>> Serge... >>>>>>>>>>>>>>>>>>>> On Tue, Jul 31, 2018 at 2:42 PM Francois Papon >>>>>>>>>>>>>>>>>>>> <[email protected]> wrote: >>>>>>>>>>>>>>>>>>>>> Hi, >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> I'm new with the Apache Unomi project and I would like to >>>>>>>>>>>>>>>>>>>>> make some >>>>>>>>>>>>>>>>>>>>> proposals around the website and the documentation :) >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> *1 - Website :* >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> Actually, the website is auto generate and link to the >>>>>>>>>>>>>>>>>>>>> project release >>>>>>>>>>>>>>>>>>>>> livecycle, however we could made some changes any time, >>>>>>>>>>>>>>>>>>>>> like posting >>>>>>>>>>>>>>>>>>>>> news, uses cases... >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> That's why I think the website can have he's dedicated >>>>>>>>>>>>>>>>>>>>> repository and >>>>>>>>>>>>>>>>>>>>> could be only build on html static pages. >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> I started a WIP with the home page and you can have a >>>>>>>>>>>>>>>>>>>>> preview here : >>>>>>>>>>>>>>>>>>>>> https://openobject.fr/unomi >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> *2 - User guide :* >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> The user guide is good and could be link to the release, >>>>>>>>>>>>>>>>>>>>> may be to major >>>>>>>>>>>>>>>>>>>>> release ? >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> We have the documentation in md format for Github and >>>>>>>>>>>>>>>>>>>>> html for the >>>>>>>>>>>>>>>>>>>>> website, we also could have a pdf from the html. >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> *3 - API Rest documentation :* >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> May be we could provided an instance of Swagger from the >>>>>>>>>>>>>>>>>>>>> website for >>>>>>>>>>>>>>>>>>>>> developers, it's convenient for have some >>>>>>>>>>>>>>>>>>>>> request/response (their is an >>>>>>>>>>>>>>>>>>>>> existing cxf-swagger feature for generating the json). >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> If you are interesting, I can help on this items :) >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> regards, >>>>>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>>>>> -- >>>>>>>>>>>>>>>>>>>>> François Papon >>>>>>>>>>>>>>>>>>>>> [email protected] >>>>>>>>>>>>>>>>>>>>>
