I don't think it's possible to load the font from a CDN for the pdf, we need to have it locally. I will search for a similar font in an Apache license. Yes, for Karaf we have a separate git repository. regards François
Envoyé depuis mon smartphone Samsung Galaxy. -------- Message d'origine --------De : Serge Huber <[email protected]> Date : 06/09/2018 18:27 (GMT+04:00) À : [email protected] Objet : Re: [PROPOSAL] - Website and documentation Hello Francois, - I'm not 100% sure it's a problem but I checked the Apache website and they are actually loading the font from the googleapis CDN, so they are not hosting it in the source code. Would there be a way to load the fonts from a remote URL or do they have to be available locally? - Thanks for the cleanup I'll look at the changes asap. - I forgot how Karaf handles the site, is there a separate git repository? cheers, Serge On Thu, Sep 6, 2018 at 9:38 AM Francois Papon <[email protected]> wrote: > > 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] > >>>>>>>>>>>>>>>>>>>>>>>> > >
