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