Hi Serge, - For the fonts, it's the SourceSansPro that is using the SIL Open Font License and I'm use it because it's the font that is used by the ASF website. If it's a problem a can choose another one.
- I removed directories and keep only the asciidoc, the PR is ok now ;) - My Github repository is up to date and I can do a PR for this. I remember that we discuss about creating a new Github repository for this (incubator-unomi-site for example), right ? regards, François Papon [email protected] Le 06/09/2018 à 10:24, Serge Huber a écrit : > Hello François, > > Thanks for all the work ! I have a coupled of questions after reviewing the > PR : > > - I noticed you use a font that is using the SIL Open Font License. I > see that it should be possible (see > https://www.apache.org/legal/resolved.html#category-b) but I'm not > sure if that doesn't imply that we need to list this under the NOTICE > file. I'm wondering if we could replace this font with an Apache > license one instead? > - I think there are some HTML and PDF files that shouldn't be in the > source. I noticed these in the following directories : > src/site/archives/1.1/html/1.4.0-incubating-SNAPSHOT > src/site/archives/1.1/pdf > src/site/archives/1.2/pdf > src/site/archives/1.2/html > Could you please remove these from the PR? > - I was wondering if we should do a second PR for the website? Did you > update your Github repository? > > Thanks again, > cheers, > Serge... > On Wed, Sep 5, 2018 at 10:04 PM Francois Papon > <[email protected]> wrote: >> Hi Serge, >> >> I clean up the PR and I remove the WIP mention, you can start the review :) >> >> regards, >> >> François Papon >> [email protected] >> >> Le 30/08/2018 à 23:08, Francois Papon a écrit : >>> 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] >>>>>>>>>>>>>>>>>>>>>>>>
