osdir.com


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Camel website


Hi Nicola,
I'm not too sure if we'd like to point users to the staging site as
the canonical source. We might get into situations that they end up
referencing those URLs when talking/promoting Camel K, and those links
might fail if we change them or at the point they access the staging
might be worst off or not rendering properly at all.

I understand the need for having the reference documentation available
for Camel K, and I'd like to say yes, but I think it would be a
disservice for Camel and Camel K to have bad user experience with the
website.

Can we publish the docs of Camel K rendered with the default or the
Camel branded Antora UI over at GitHub pages for now, would that work?

zoran

On Fri, Dec 21, 2018 at 12:53 PM Nicola Ferraro <ni.ferraro@xxxxxxxxx> wrote:
>
> I've refactored most of the .adoc files in Camel K and the manual looks
> nicer now: https://camel.apache.org/staging/camel-k/latest/
>
> Is it ok if I point users to staging for documentation (after fixing some
> glitches)?
> So we can write new doc on Camel K master..
> @Zoran <zregvart@xxxxxxxxxx> wdyt?
>
>
> On Wed, Dec 19, 2018 at 3:23 AM Tadayoshi Sato <sato.tadayoshi@xxxxxxxxx>
> wrote:
>
> > Awesome job, Francois!  That's really modern & cool web site!
> >
> > On Tue, Dec 18, 2018 at 9:06 PM Francois Papon <
> > francois.papon@xxxxxxxxxxxxx>
> > wrote:
> >
> > > Cool!
> > >
> > > I will push a PR for the responsive soon.
> > >
> > > Regards,
> > >
> > > François Papon
> > > fpapon@xxxxxxxxxx
> > >
> > > Le 18/12/2018 à 15:51, Zoran Regvart a écrit :
> > > > Thank you François, I merged your PR to camel-website master and it's
> > > > now on staging:
> > > >
> > > > https://camel.apache.org/staging/
> > > >
> > > > looks pretty good :)
> > > >
> > > > zoran
> > > >
> > > > On Mon, Dec 17, 2018 at 11:19 AM Francois Papon
> > > > <francois.papon@xxxxxxxxxxxxx> wrote:
> > > >> Hi,
> > > >>
> > > >> Thanks for your feeback!
> > > >>
> > > >> For the mobile responsive, I didn't work on it yet but I keep it in
> > > mind ;)
> > > >>
> > > >> Regards,
> > > >>
> > > >> François Papon
> > > >> fpapon@xxxxxxxxxx
> > > >>
> > > >> Le 17/12/2018 à 12:41, Andrea Cosentino a écrit :
> > > >>> Really nice! Only that problem on mobile, but it looks great.
> > > >>>
> > > >>> --
> > > >>> Andrea Cosentino
> > > >>> ----------------------------------
> > > >>> Apache Camel PMC Chair
> > > >>> Apache Karaf Committer
> > > >>> Apache Servicemix PMC Member
> > > >>> Email: ancosen1985@xxxxxxxxx
> > > >>> Twitter: @oscerd2
> > > >>> Github: oscerd
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >>> On Monday, December 17, 2018, 9:33:21 AM GMT+1, Onder SEZGIN <
> > > onders@xxxxxxxxxx> wrote:
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >>> Thanks François. It looks very nice.
> > > >>> One minor comment:
> > > >>> Look and feel is overlapping on mobile view. Maybe it could be
> > > adjusted to
> > > >>> be more responsive.
> > > >>>
> > > >>> On Sun, Dec 16, 2018 at 3:59 PM Zoran Regvart <zoran@xxxxxxxxxxx>
> > > wrote:
> > > >>>
> > > >>>> Hi François,
> > > >>>> I think that's awesome! Please do create a PR :)
> > > >>>>
> > > >>>> zoran
> > > >>>> On Sat, Dec 15, 2018 at 7:28 PM Francois Papon
> > > >>>> <francois.papon@xxxxxxxxxxxxx> wrote:
> > > >>>>> Hi guys,
> > > >>>>>
> > > >>>>> I made some design integration on the website based on the new
> > logo,
> > > >>>>> it's not fully finished and it's just a proposal.
> > > >>>>>
> > > >>>>> You can have a preview about the home page here :
> > > >>>>>
> > > >>>>> https://openobject.fr/camel/
> > > >>>>>
> > > >>>>> If you like it I'm ready to push my PR and move forward with the
> > > >>>>> documentation theme ;)
> > > >>>>>
> > > >>>>> Regards,
> > > >>>>>
> > > >>>>> François Papon
> > > >>>>> fpapon@xxxxxxxxxx
> > > >>>>>
> > > >>>>> Le 14/12/2018 à 18:03, Claus Ibsen a écrit :
> > > >>>>>> Hi
> > > >>>>>>
> > > >>>>>> Yay its good to see progress on this, and that we can easily have
> > a
> > > >>>>>> sneak-peak by browsing that staging site.
> > > >>>>>>
> > > >>>>>> Great work guys, love to see the collaboration going on, to
> > > >>>>>> reinvigorate the Camel project and its website.
> > > >>>>>>
> > > >>>>>>
> > > >>>>>> On Thu, Dec 13, 2018 at 12:36 PM Zoran Regvart <zoran@xxxxxxxxxxx
> > >
> > > >>>> wrote:
> > > >>>>>>> Hi Cameleers,
> > > >>>>>>> the first iteration of the build[1] of the new website is up on
> > the
> > > >>>> staging URL:
> > > >>>>>>> https://camel.apache.org/staging/
> > > >>>>>>>
> > > >>>>>>> it took a while to get all the kinks worked out but it seems OK
> > > now.
> > > >>>>>>>
> > > >>>>>>> Bare in mind that this is still very early, rough version: links
> > > will
> > > >>>>>>> be broken or point to wrong places, layout and styling is almost
> > > >>>>>>> non-existant.
> > > >>>>>>>
> > > >>>>>>> This at least gives us the opportunity to see any changes we make
> > > >>>>>>> really quickly online.
> > > >>>>>>>
> > > >>>>>>> I'll work on adding some READMEs to explain how to contribute and
> > > >>>>>>> cleanup JIRA issues around the new website next.
> > > >>>>>>>
> > > >>>>>>> zoran
> > > >>>>>>>
> > > >>>>>>> [1]
> > > >>>>
> > >
> > https://builds.apache.org/blue/organizations/jenkins/Camel.website/activity
> > > >>>>>>> --
> > > >>>>>>> Zoran Regvart
> > > >>>> --
> > > >>>> Zoran Regvart
> > > >>>>
> > > >
> > > >
> > >
> >



-- 
Zoran Regvart