Hi Serge, I removed the SourceSansPro font and replaced it by the OpenSans in both HTML and PDF.
It's looks pretty good :) regards, François Papon [email protected] Le 06/09/2018 à 20:36, francois.papon a écrit : > 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] >>>>>>>>>>>>>>>>>>>>>>>>>> >>
