I found I'm not able to start a vote now, because I don't clearly understand how to create a presentation using AsciiDoc. I will research it and then will be able to start it.
пт, 1 мар. 2019 г. в 09:36, Dmitriy Pavlov <[email protected]>: > Yes I personally agree to try asciidoc, but I think we should create 2 > separated threads for voting to be visible by all members. I could start > that threads. > > пт, 1 мар. 2019 г., 0:08 Christofer Dutz <[email protected]>: > >> Hi Lars, >> >> I would be more than happy to setup everything ... >> >> Chris >> >> Am 28.02.19, 19:20 schrieb "Lars Francke" <[email protected]>: >> >> I've looked at the plc4x website and think it looks good. The source >> seems >> to be relatively painless as well and I like Asciidoc, so it works in >> my >> book. >> >> Does any of you have any opinions on a technology/framework? (I don't >> really) >> >> If not I suggest that we do a quick vote on it. >> Christofer would you be interested in helping set that up should we >> go that >> route? >> >> On Sun, Feb 24, 2019 at 3:32 AM Sönke Liebau >> <[email protected]> wrote: >> >> > I think a separate repo for the website makes sense, to keep things >> a >> > little separated. It depends on what route we choose regarding >> repos, but >> > my preference would be to keep the main "content" repo free of any >> admin >> > (for lack of a better word) stuff. >> > Regarding a staging repo, for our website we currently forego this >> step >> > completely, our build job takes the sources (we use Lektor) and >> compiles >> > them straight to the directory the page is served from. >> > While saving an extra repo this also means that we lack proper >> versioning, >> > as any changes to the build job might of course also affect >> rebuilds of >> > older versions of the page. >> > >> > I don't have any real preference here tbh, I think we should mostly >> be >> > looking to reuse as much as possible. >> > >> > Best regards, >> > Sönke >> > >> > >> > >> > [1] https://www.getlektor.com >> > >> > Am Sa., 23. Feb. 2019, 21:01 hat Furkan KAMACI < >> [email protected]> >> > geschrieben: >> > >> > > Hi, >> > > >> > > The website can be a separate repo ( >> > > https://github.com/apache/incubator-dubbo-website), a different >> branch >> > or >> > > resides in the original repo ( >> > > https://github.com/apache/incubator-druid/tree/master/docs). >> > > >> > > I think that it depends on which repositories we will have on >> Github. As >> > > far as I see, a separate repo for such purpose could be better. >> > Generating >> > > a website from AsciiDoc >> > > could be nice i.e. https://plc4x.apache.org or >> > > https://cloudstack.apache.org >> > > >> > > On the other hand, generating a website from mkdocs via gh-pages ( >> > > >> https://www.mkdocs.org/user-guide/deploying-your-docs/#github-pages) can >> > > be >> > > another option if possible. >> > > >> > > Kind Regards, >> > > Furkan KAMACI >> > > >> > > >> > > On Sat, Feb 23, 2019 at 7:17 PM Kenneth Knowles <[email protected]> >> wrote: >> > > >> > > > You can do it all in our repo: keep source for the site on >> `master` >> > > branch >> > > > and the rendered site on `asf-site`, much like GitHub does with >> > > `gh-pages`. >> > > > Beam does this. Slightly less to administer. But on the other >> hand, if >> > > you >> > > > *want* to set up permissions differently (like "only a bot can >> push"), >> > or >> > > > just want to stay flexible, then having a separate technical >> repo is >> > > likely >> > > > better. >> > > > >> > > > Kenn >> > > > >> > > > On Sat, Feb 23, 2019 at 2:17 AM Christofer Dutz < >> > > [email protected] >> > > > > >> > > > wrote: >> > > > >> > > > > One thing with "one repo" and the reason we stage the website >> in a >> > > > > separate one. >> > > > > The commit history is polluted with all the website-staging >> > > auto-emails. >> > > > > >> > > > > So I would suggest a "technical repo" where the site is >> staged for >> > > pickup >> > > > > by git-pub-sub. >> > > > > >> > > > > Chris >> > > > > >> > > > > Am 23.02.19, 11:07 schrieb "Lars Francke" < >> [email protected]>: >> > > > > >> > > > > Fabulous! I think that looks good, I like Asciidoc, I >> understand >> > > > Maven >> > > > > so >> > > > > to me that sounds good. Thank you. Let's see what others >> have to >> > > say. >> > > > > >> > > > > All in one repo as Kenneth mentioned also sounds good to >> me. >> > > > > >> > > > > That reminds me: A logo would be good. The ASF now has a >> Central >> > > > > Service >> > > > > that we could ask for a Logo design. >> > > > > >> > > > > On Sat, Feb 23, 2019 at 10:35 AM Christofer Dutz < >> > > > > [email protected]> >> > > > > wrote: >> > > > > >> > > > > > Hi, >> > > > > > >> > > > > > well I could help with this. >> > > > > > I guess the PLC4X podling is the cleanest of my >> examples for a >> > > > setup >> > > > > in >> > > > > > which the website is generated from asciidoc as part of >> the >> > maven >> > > > > build >> > > > > > And it is also automatically staged and published by >> > git-pub-sub. >> > > > > > IANAWD (I am not a web designer), and the content >> definitely >> > > needs >> > > > an >> > > > > > update, but I'm quite happy with the results. >> > > > > > >> > > > > > https://plc4x.apache.org >> > > > > > >> > > > > > Chris >> > > > > > >> > > > > > Am 23.02.19, 01:06 schrieb "Kenneth Knowles" < >> [email protected] >> > >: >> > > > > > >> > > > > > It can all be in one repo. Beam recently moved the >> site >> > from >> > > > the >> > > > > > apache/beam-site repo to a directory in the main >> > apache/beam >> > > > > repo. It >> > > > > > is >> > > > > > nice to not have multiple places you have to go >> looking for >> > > > > bits. And >> > > > > > it is >> > > > > > published on every commit using gitpubsub. I didn't >> set >> > that >> > > > up, >> > > > > but I >> > > > > > can >> > > > > > ask around. We've had a pretty good time with Jekyll >> > though I >> > > > > think >> > > > > > mostly >> > > > > > we don't change it since it is working. I think >> various >> > > flavors >> > > > > of >> > > > > > markdown >> > > > > > have the most widespread support. >> > > > > > >> > > > > > Kenn >> > > > > > >> > > > > > On Fri, Feb 22, 2019 at 2:49 PM Lars Francke < >> > > > > [email protected]> >> > > > > > wrote: >> > > > > > >> > > > > > > We need a website :) >> > > > > > > >> > > > > > > I have almost no skills in any kind of frontend >> work. >> > > > CSS/HTML >> > > > > etc. >> > > > > > That >> > > > > > > means I also don't have any strong opinions on >> this but I >> > > > know >> > > > > that >> > > > > > some of >> > > > > > > you (Christofer etc.) have already dealt with >> this in >> > other >> > > > > projects. >> > > > > > > >> > > > > > > I'm happy to help with content when the basics are >> > set-up. >> > > > > > > >> > > > > > > The only opinion I do have is that it'd be good >> to have >> > the >> > > > > content >> > > > > > in a >> > > > > > > format like Asciidoc - ideally in the same format >> as >> > > some/all >> > > > > of our >> > > > > > actual >> > > > > > > content. >> > > > > > > >> > > > > > > It'd be fabulous if anyone is willing to take >> this up? >> > > > > > > >> > > > > > > I know that Infra has a "gitpubsub" thing which >> allows us >> > > to >> > > > > > automatically >> > > > > > > build and deploy a site from git somehow. I've >> never used >> > > it >> > > > > and >> > > > > > there are >> > > > > > > lots of things I don't know. One of them being >> whether it >> > > can >> > > > > all be >> > > > > > one >> > > > > > > repository or whether we need a training-site >> repo. >> > > > > > > >> > > > > > > <https://www.apache.org/dev/project-site.html> >> > > > > > > <https://www.apache.org/dev/gitpubsub.html> >> > > > > > > >> > > > > > >> > > > > > >> > > > > > >> > > > > >> > > > > >> > > > > >> > > > >> > > >> > >> >> >>
