Yes the PR is up to date ;) regards,
François Papon [email protected] Le 07/09/2018 à 10:07, Serge Huber a écrit : > That's great news ! Is the PR up to date ? > > I think we can merge it now. We will need to ask for the git repo for > the website quickly. > > Thanks & Regards, > Serge... > > > > On Thu, Sep 6, 2018 at 8:20 PM Francois Papon > <[email protected]> wrote: >> 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] >>>>>>>>>>>>>>>>>>>>>>>>>>>>
