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] > >>>>>>>>>>>>>>>>>>>>>>>>>> > >> >
