royale-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Carlos Rovira <carlosrov...@apache.org>
Subject Re: Proposed table of contents for Royale help documentation
Date Fri, 26 Jan 2018 00:17:12 GMT
Hi Alex,

getting up with the last day info. Right, I'll try this week-end to make
something that looks good. First I have to figure how to work taking into
account the other threads I read and the way you guys are working.
Thanks

2018-01-25 0:23 GMT+01:00 Alex Harui <aharui@adobe.com.invalid>:

> MIT is fine, as is BSD.  But again, if the theme has many parts, it may
> result in the PMC spending time researching each of the parts.  Just
> because the theme author claims MIT for his work, he might have used
> third-party works under other licenses that aren't as compatible with the
> Apache License.
>
> I guess my question is this:  I don't expect that the look-and-feel of our
> documentation pages needs much if any animation.  IOW, I would think the
> visuals around the content will be pretty much static.  If that's the
> case, why will it be so difficult to just continue improving the template
> I put in there?  If you want to take a theme and WP and mock up something
> quickly, that's fine as long as all of the creativity can be considered
> yours or under a friendly license.  But maybe instead of another export of
> a WP theme, we should just try to mimic that in plain HTML.  I think I got
> pretty close to the royale.a.o look in the docpage.html template.
>
> Thoughts?
> -Alex
>
> On 1/24/18, 1:57 PM, "carlos.rovira@gmail.com on behalf of Carlos Rovira"
> <carlos.rovira@gmail.com on behalf of carlosrovira@apache.org> wrote:
>
> >Hi Alex,
> >
> >right, I'm looking for something that is ALv2. Unfortunately almost all
> >docs themes are MIT license. Is MIT right for us?
> >
> >2018-01-24 18:14 GMT+01:00 Alex Harui <aharui@adobe.com.invalid>:
> >
> >> Hi Carlos,
> >>
> >> Right now, the master branch is set up to use the Cayman theme.  When I
> >> took a quick look at Cayman, it appeared to be under Creative Commons,
> >> which makes it very difficult for us to use.  Unfortunately, just
> >>because
> >> it is "Open Source" and on GitHub doesn't mean it is compatible with the
> >> Apache License.  That was one reason I put in a docpage.html as the
> >> initial template for the doc site.  If you can find a simple theme that
> >> isn't under CC, then let's take a look at it, but every third party
> >>theme
> >> seems to have lots of pieces and is going to have to get scrubbed which
> >> takes us time thinking about legal stuff.  I believe we can
> >>incrementally
> >> add to the initial template or make different templates over time and
> >>make
> >> a first-class doc site without having to spend so much time scrubbing
> >> other people's works.  I don't think people are going to care too much
> >> about how cool our doc site is, at least not right now.  I don't think
> >> there is a rush to make it cool.  On the other hand, we do want to make
> >>a
> >> good first impression over at royale.a.o, which is why I'm glad you have
> >> provided something great for that.
> >>
> >> My 2 cents,
> >> -Alex
> >>
> >> On 1/24/18, 12:45 AM, "carlos.rovira@gmail.com on behalf of Carlos
> >>Rovira"
> >> <carlos.rovira@gmail.com on behalf of carlosrovira@apache.org> wrote:
> >>
> >> >Hi Alex, for this reason is better to go with a OS GitHub theme that
> >>only
> >> >needs to use the colors, fonts and logos from our website. Those where
> >> >selected by me and are not provided by the WP theme. The other main
> >>reason
> >> >is that we need to use something done for that task with the maximum
> >> >quality. And that is something we can develop ourselves from scratch
> >> >without invest lots of time.
> >> >
> >> >2018-01-24 5:10 GMT+01:00 Alex Harui <aharui@adobe.com.invalid>:
> >> >
> >> >> Personally, I would be very cautious about WP themes or copying
> >> >> look-and-feel of other sites.  I would like our doc to be
> >>license-able
> >> >> under ALv2 and not run into IP and licensing issues.
> >> >>
> >> >> -Alex
> >> >>
> >> >> On 1/23/18, 3:11 PM, "carlos.rovira@gmail.com on behalf of Carlos
> >> >>Rovira"
> >> >> <carlos.rovira@gmail.com on behalf of carlosrovira@apache.org>
> wrote:
> >> >>
> >> >> >Hi,
> >> >> >
> >> >> >I tried to read through this thread, but many mails to catch all
> >>whats
> >> >> >happening at the moment, and just want to say a couple of things:
> >> >> >
> >> >> >1.- Regarding TOC, I think it's ok (in a quick review, I should
> >>work a
> >> >>bit
> >> >> >on docs too to see how this works). But as anything, I assume that
> >> >>it's a
> >> >> >starting point and we should be working on it a evolving it as
we
> >> >> >experience it.
> >> >> >
> >> >> >2.- Although Flex doc is a good start I want to point as well to
> >> >>React[1]
> >> >> >and Angular[2] to compare with what we want to do to get/copy ideas
> >>on
> >> >>how
> >> >> >they are doing things and help to get same level of quality and/or
> >>even
> >> >> >improve over it. I use to always reference this two projects since
> >>are
> >> >>the
> >> >> >standard right now in any aspect and we should compare what we
do
> >>with
> >> >> >those.
> >> >> >
> >> >> >React seems to use Github pages as well and the index/menu systems
> >> >>seems
> >> >> >very appropriate.
> >> >> >
> >> >> >3.- I think we should use that kind of layout and not try to
> >>"emulate"
> >> >>the
> >> >> >exact look and feel in our site. I think that would not result
in
> >> >> >something
> >> >> >cool in the end. To do that I'll go directly the most easy way
that
> >>is
> >> >>to
> >> >> >do it in WP instance in no time. We are trying to use Gihub Pages
to
> >> >>get
> >> >> >something like [2] and that's done with a GitHub pages documentation
> >> >> >already done. With that in place we only need to change some colors
> >>(to
> >> >> >oranges and blues) and fonts, and add royale logo to match website,
> >>but
> >> >> >getting something unique for our docs.
> >> >> >
> >> >> >Hope to get soon to this and could help in this task.
> >> >> >
> >> >> >Thanks
> >> >> >
> >> >> >
> >> >> >[1]
> >> >> >https://na01.safelinks.protection.outlook.com/?url=
> >> >> https%3A%2F%2Freactjs.o
> >> >> >rg%2Fdocs%2F&data=02%7C01%7Caharui%40adobe.com%
> >> >> 7Cb2e14e4d2a974d55307108d56
> >> >> >2b6bb97%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%
> >> >> 7C636523459331863020&sd
> >> >> >ata=eJA6clo4TdLGQqSA2KQf400woq2tw0%2BLq%2F0Di8eCnDc%3D&reserved=0
> >> >> >[2]
> >> >> >https://na01.safelinks.protection.outlook.com/?url=
> >> >> https%3A%2F%2Fangular.i
> >> >>
> >> >>>o%2Fdocs&data=02%7C01%7Caharui%40adobe.com%
> >> 7Cb2e14e4d2a974d55307108d562b
> >> >>>6
> >> >> b
> >> >> >b97%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%
> >> >> 7C636523459331863020&sdata=
> >> >> >ESznd%2FS49ExgogHbPN9HIF%2B4iHI%2FxwX5Tqw4xnndkSQ%3D&reserved=0
> >> >> >
> >> >> >2018-01-23 22:30 GMT+01:00 Andrew Wetmore <cottage14@gmail.com>:
> >> >> >
> >> >> >> I have set up 2FA and presume I have to wait a while until
GitHub
> >> >> >>notices.
> >> >> >> In the mean time I may create another page or two offline...
> >> >> >>
> >> >> >> On Tue, Jan 23, 2018 at 4:41 PM, Andrew Wetmore
> >><cottage14@gmail.com
> >> >
> >> >> >> wrote:
> >> >> >>
> >> >> >> > I have requested my authentication code, but it seems
to be slow
> >> >> >> > arriving...Will wait.
> >> >> >> >
> >> >> >> > On Tue, Jan 23, 2018 at 4:28 PM, Alex Harui
> >> >><aharui@adobe.com.invalid
> >> >> >
> >> >> >> > wrote:
> >> >> >> >
> >> >> >> >> Hi Andrew,
> >> >> >> >>
> >> >> >> >> Infra did more checking and says that you haven't
enabled 2FA
> >>on
> >> >>GH
> >> >> >> which
> >> >> >> >> is why you are being denied. The links below may
help you do
> >>that.
> >> >> >> >>
> >> >> >> >>
> >> >> >>https://na01.safelinks.protection.outlook.com/?url=
> >> >> https%3A%2F%2Fhelp.git
> >> >> >>hub.com%2Farticles%2Fsecuring-your-account-with-&
> >> >> data=02%7C01%7Caharui%40
> >> >> >>adobe.com%7Cb2e14e4d2a974d55307108d562b6bb97%
> >> >> 7Cfa7b1b5a7b34438794aed2c178
> >> >>
> >> >>>>decee1%7C0%7C0%7C636523459331863020&sdata=
> >> Q2ze2F5qsl6bUfvex6mAxuXFbpbtm
> >> >>>>p
> >> >> U
> >> >> >>7Mw2Ntb3pOBY%3D&reserved=0
> >> >> >> >> two-factor-auth
> >> >> >> >> entication-2fa/
> >> >> >> >>
> >> >> >><https://na01.safelinks.protection.outlook.com/?url=
> >> >> https%3A%2F%2Fhelp.gi
> >> >> >>thub.com%2Farticles%2Fsecuring-your-&data=02%7C01%7Caharui%
> >> 40adobe.com
> >> >> %7C
> >> >> >>b2e14e4d2a974d55307108d562b6bb97%7Cfa7b1b5a7b34438794aed2c178de
> >> >> cee1%7C0%7
> >> >> >>C0%7C636523459331863020&sdata=U%2BkahP6uVxrBuGG6pcvI1QgJqHayIv
> >> >> cwYQF7WWswi
> >> >> >>zs%3D&reserved=0
> >> >> >> account-with-two-factor-authentication-2fa/>
> >> >> >> >>
> >> >> >>https://na01.safelinks.protection.outlook.com/?url=
> >> >> https%3A%2F%2Fhelp.git
> >> >> >>hub.com%2Farticles%2Fproviding-your-2fa-&data=02%7C01%7Caharui%
> >> >> 40adobe.co
> >> >> >>m%7Cb2e14e4d2a974d55307108d562b6bb97%
> 7Cfa7b1b5a7b34438794aed2c178de
> >> >> cee1%7
> >> >> >>C0%7C0%7C636523459331863020&sdata=xQLEPxW3yhH%
> >> >> 2FqIRe2BHn0Ly%2Fm4cki9p4hst
> >> >> >>4H8XH%2BV8%3D&reserved=0
> >> >> >> authentication-code/
> >> >> >> >>
> >> >> >> >>
> >> >> >> >> --
> >> >> >> > Andrew Wetmore
> >> >> >> >
> >> >> >> >
> >> >> >>https://na01.safelinks.protection.outlook.com/?url=
> >> >> http%3A%2F%2Fcottage14
> >> >> >>.blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%
> >> >> 7Cb2e14e4d2a974d553071
> >> >> >>08d562b6bb97%7Cfa7b1b5a7b34438794aed2c178de
> >> >> cee1%7C0%7C0%7C636523459331863
> >> >> >>020&sdata=Fj6dhqNUJNGm5IhplxseRaJDuC1egP
> IS7lsxcBt6ejg%3D&reserved=0
> >> >> >> >
> >> >> >> >
> >> >> >> >
> >> >> >> >
> >> >> >> >
> >> >> >>
> >> >> >>
> >> >> >> --
> >> >> >> Andrew Wetmore
> >> >> >>
> >> >> >>
> >> >> >>https://na01.safelinks.protection.outlook.com/?url=
> >> >> http%3A%2F%2Fcottage14
> >> >> >>.blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%
> >> >> 7Cb2e14e4d2a974d553071
> >> >> >>08d562b6bb97%7Cfa7b1b5a7b34438794aed2c178de
> >> >> cee1%7C0%7C0%7C636523459331863
> >> >> >>020&sdata=Fj6dhqNUJNGm5IhplxseRaJDuC1egP
> IS7lsxcBt6ejg%3D&reserved=0
> >> >> >>
> >> >> >
> >> >> >
> >> >> >
> >> >> >--
> >> >> >Carlos Rovira
> >> >> >https://na01.safelinks.protection.outlook.com/?url=
> >> >> http%3A%2F%2Fabout.me%2
> >> >> >Fcarlosrovira&data=02%7C01%7Caharui%40adobe.com%
> >> >> 7Cb2e14e4d2a974d55307108d5
> >> >> >62b6bb97%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%
> >> >> 7C636523459331863020&s
> >> >> >data=yO%2FEQwi0y2LQCGV1dnFWypPcOAhYeIrGsXRbLtPcmwI%3D&reserved=0
> >> >>
> >> >>
> >> >
> >> >
> >> >--
> >> >Carlos Rovira
> >> >https://na01.safelinks.protection.outlook.com/?url=
> >> http%3A%2F%2Fabout.me%2
> >> >Fcarlosrovira&data=02%7C01%7Caharui%40adobe.com%
> >> 7C5b9bda044c21467b37c008d5
> >> >6306d3a5%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%
> >> 7C636523803340777488&s
> >> >data=t1er5VGrZtk9NKp6m47PmcpCicTy5dReUDJRny5AN%2B0%3D&reserved=0
> >>
> >>
> >
> >
> >--
> >Carlos Rovira
> >https://na01.safelinks.protection.outlook.com/?url=
> http%3A%2F%2Fabout.me%2
> >Fcarlosrovira&data=02%7C01%7Caharui%40adobe.com%
> 7Ce5c9c51d0e524d97ff2d08d5
> >6375988b%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%
> 7C636524279098229179&s
> >data=5dwzJa%2FcGWd%2BN7sS3b2J%2FSmgRaJ0rRbnRBESq41N2KI%3D&reserved=0
>
>


-- 
Carlos Rovira
http://about.me/carlosrovira

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message