Hi Carlos, I don't know how big the changes you are thinking of and how much time you have, but you could mock up something in your WP instance or post an image and I could try to make the changes in the current template.
Let me know, -Alex On 1/25/18, 4:17 PM, "carlos.rov...@gmail.com on behalf of Carlos Rovira" <carlos.rov...@gmail.com on behalf of carlosrov...@apache.org> wrote: >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 <aha...@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.rov...@gmail.com on behalf of Carlos >>Rovira" >> <carlos.rov...@gmail.com on behalf of carlosrov...@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 <aha...@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.rov...@gmail.com on behalf of Carlos >> >>Rovira" >> >> <carlos.rov...@gmail.com on behalf of carlosrov...@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 <aha...@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.rov...@gmail.com on behalf of Carlos >> >> >>Rovira" >> >> >> <carlos.rov...@gmail.com on behalf of carlosrov...@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 <cottag...@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 >> >><cottag...@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 >> >> >><aha...@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 >https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2 >Fcarlosrovira&data=02%7C01%7Caharui%40adobe.com%7Cacb06ad8d95041967c5608d5 >645236bc%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525226626178284&s >data=4k7QlJiRTS190z5TtLiffBGpzHIuwmRttVtaDmabpz0%3D&reserved=0