All, Just wondering, can we consider this a binding vote? Just want to make sure I have the right links in place.
John On Mon, Aug 11, 2014 at 12:04 PM, John D. Ament <john.d.am...@gmail.com> wrote: > +1 as well. I can push this folder in to master after 1.0.2 is release, > so as to not mess up Gerhard. > > > On Mon, Aug 11, 2014 at 11:56 AM, Jason Porter <lightguard...@gmail.com> > wrote: > >> +1 from me. — >> Sent from Mailbox >> >> On Mon, Aug 11, 2014 at 9:54 AM, Rafael Benevides <benevi...@redhat.com> >> wrote: >> >> > I ran the PoC and I do really thing that it works for DeltaSpike >> > (considering that there's no restriction on CMS). >> > Can I give a green sign to Michelle start the docs refactoring (as >> > planned) using Asciidoctor? I think that she and her team can work on >> > its own repository and them move it in one big shot once that we have >> > all requirements setup. Wdyt ? >> > Em 8/11/14, 8:17, John D. Ament escreveu: >> >> @mark >> >> >> >> That's what I based it on actually. >> >> >> >> >> >> On Mon, Aug 11, 2014 at 12:44 AM, Mark Struberg <strub...@yahoo.de> >> wrote: >> >> >> >>> You can look at batchee. >> >>> >> >>> Romain configured offline doc (with markdown, but could also be >> asciidoc) >> >>> and mvn scm-publish >> >>> >> >>> LieGrue, >> >>> strub >> >>> >> >>> >> >>> -------------------------------------------- >> >>> On Sat, 9/8/14, John D. Ament <john.d.am...@gmail.com> wrote: >> >>> >> >>> Subject: Re: DeltaSpike docs plan >> >>> To: "deltaspike" <dev@deltaspike.apache.org> >> >>> Date: Saturday, 9 August, 2014, 15:54 >> >>> >> >>> Actually, from digging >> >>> around their code, might have an easier solution, so >> >>> long as everyone agrees. >> >>> >> >>> I have a small POC setup here: >> >>> >> >>> >> https://github.com/johnament/deltaspike/commit/402becc0e450e551570107a1661d39e9eb6a43cb >> >>> >> >>> I setup a local VM w/ a SVN >> >>> repo to test it out. Basically, we can >> >>> generate the asciidoc locally using mvn site, >> >>> then run mvn site-deploy to >> >>> move the >> >>> rendered files to staging. Once done, login to CMS and >> >>> promote to >> >>> prod. >> >>> >> >>> The only change would be to get infra to switch >> >>> our script to use the shell >> >>> option. It >> >>> does put the rendering process on whoever is writing the >> >>> docs, >> >>> but since it's using the java >> >>> plugin and jruby, nothing should need to be >> >>> downloaded separately to machines. >> >>> >> >>> >> >>> On Fri, Aug 8, 2014 at 1:55 >> >>> PM, Rafael Benevides <benevi...@redhat.com> >> >>> wrote: >> >>> >> >>> > I >> >>> remember that someone said that CMS already supports >> >>> remote >> >>> > repositories. Can't we start >> >>> by having this documents moved soon while we >> >>> > discuss about the asciidoc rendering ? >> >>> > >> >>> > Em 8/8/14, 10:53, >> >>> Gerhard Petracek escreveu: >> >>> > >> >>> > @john: >> >>> >> the >> >>> infra team is usually not the blocking part (if there is >> >>> no >> >>> >> significant >> >>> >> technical issue and they don't get >> >>> a new heavy part to maintain). >> >>> >> >> >>> >> regards, >> >>> >> >> >>> gerhard >> >>> >> >> >>> >> >> >>> >> >> >>> >> 2014-08-08 >> >>> 15:37 GMT+02:00 John D. Ament <john.d.am...@gmail.com>: >> >>> >> >> >>> >> I think we >> >>> need to convince infra@ that these are all must needed >> >>> >>> features. >> >>> >>> From looking at the >> >>> code behind CMS, it would appear that it's the one >> >>> >>> calling markdown based on the >> >>> imports in our files. Unless we want to do >> >>> >>> something crazy like render >> >>> asciidoc in markdown format, then hand that >> >>> >>> over for rendering.. >> >>> >>> >> >>> >>> Still >> >>> would need to convince that pulling from git over the svn >> >>> site is >> >>> >>> ideal as well. >> >>> >>> >> >>> >>> >> >>> John >> >>> >>> >> >>> >>> >> >>> >>> On >> >>> Fri, Aug 8, 2014 at 9:03 AM, Rafael Benevides <benevi...@redhat.com >> > >> >>> >>> wrote: >> >>> >>> >> >>> >>> Em >> >>> 8/8/14, 6:49, Pete Muir escreveu: >> >>> >>>> >> >>> >>>> On 7 Aug 2014, at >> >>> 18:47, Rafael Benevides <benevi...@redhat.com> >> >>> >>>> wrote: >> >>> >>>> >> >>> >>>>> Before we >> >>> have a deal with Michelle's team about these content >> >>> >>>>> changes, >> >>> >>>>> >> >>> >>>>>> I think we should >> >>> close the two other definitions: >> >>> >>>>>> >> >>> >>>>>> - docs location: move >> >>> to deltaspike sources, create a new repository, >> >>> >>>>>> other? >> >>> >>>>>> >> >>> >>>>>> +1 to move to >> >>> sources >> >>> >>>>> >> >>> >>>>> +1 to move to sources >> >>> >>>> >> >>> >>>> and >> >>> >>>>> >> >>> >>>>>> -docs format: markdown >> >>> or asciidoc >> >>> >>>>>> >> >>> >>>>>> +1 for asciidoc. >> >>> >>>>> >> >>> >>>>> +1 for asciidoc >> >>> >>>> >> >>> >>>> >> >>> >>>> However I believe we also >> >>> need agree on: >> >>> >>>>> >> >>> >>>>> * add support for asciidoc >> >>> to Apache CMS >> >>> >>>>> * add >> >>> support for importing external repo to Apache CMS >> >>> >>>>> >> >>> >>>>> so that the docs can still >> >>> be build as part of the website. >> >>> >>>>> >> >>> >>>>> From what >> >>> people have said in the past, both are possible, if >> >>> someone >> >>> >>>>> (e.g. Rafael >> >>> ;-) can spend a couple of days doing it. >> >>> >>>>> >> >>> >>>>> Definitely I would like >> >>> to help/handle that. I believe that both >> >>> >>>> >> >>> >>> >> >>> (asciidoc >> >>> >>> >> >>> >>>> support + importing external >> >>> repo) will bring open doors to >> >>> >>>> documentation >> >>> >>>> contribution. >> >>> >>>> >> >>> >>>> >> >>> >>>> I believe that we should >> >>> propose a vote to decided this, otherwise it >> >>> >>>>> >> >>> >>>>>> can become an endless >> >>> discussion. Wdyt ? >> >>> >>>>>> >> >>> >>>>>> >> >>> >>>>>> >> >>> >>>>>> Em 8/4/14, 17:28, >> >>> Gerhard Petracek escreveu: >> >>> >>>>>> >> >>> >>>>>> @suggested content >> >>> changes: >> >>> >>>>>>> +1 >> >>> >>>>>>> >> >>> >>>>>>> regards, >> >>> >>>>>>> gerhard >> >>> >>>>>>> >> >>> >>>>>>> >> >>> >>>>>>> >> >>> >>>>>>> 2014-08-01 18:46 >> >>> GMT+02:00 Rafael Benevides <benevi...@redhat.com >> >>> >>>>>>> <mailto:benevi...@redhat.com>>: >> >>> >>>>>>> >> >>> >>>>>>> Hi all, >> >>> >>>>>>> >> >>> >>>>>>> As you may >> >>> known, Red Hat docs team was called to help on >> >>> >>>>>>> DeltaSpike >> >>> docs. After a long period, they have analyzed the >> >>> >>>>>>> >> >>> documentation and bring us an awesome plan that is >> >>> available >> >>> >>>>>>> >> >>> here: >> >>> >>>>>>> >> >>> https://docs.google.com/document/d/186f_ >> >>> >>>>>>> >> >>> amQ9XuREq8FcO7orxvOjQZtvEEYa7WPj1e8p8bM/edit#heading=h.4sqhyz68wgg2 >> >>> >>>>>>> >> >>> >>>>>>> The >> >>> document is opened for comments. >> >>> >>>>>>> >> >>> >>>>>>> Something >> >>> that was also discussed not only inside Red Hat but >> >>> >>>>>>> with >> >>> >>>>>>> some >> >>> community members is about the format and source of the >> >>> >>>>>>> >> >>> documentation. I strongly believe that we should have the >> >>> >>>>>>> >> >>> documentation somewhere else but the DS site source. It >> >>> could >> >>> >>>>>>> >> >>> improve the ease to the community to contribute with it. >> >>> Having >> >>> >>>>>>> >> >>> said that, it's also suggested that we should use >> >>> asciidoc as >> >>> >>>>>>> >> >>> documentation format. >> >>> >>>>>>> >> >>> >>>>>>> So what we >> >>> have until now ? >> >>> >>>>>>> >> >>> >>>>>>> - The >> >>> documentation plan to be reviewed and approved by the DS >> >>> >>>>>>> community. >> >>> Then we can talk about the plans to make it happen. >> >>> >>>>>>> - The >> >>> documentation location: Recommendation to be out of the >> >>> >>>>>>> site >> >>> >>>>>>> source. >> >>> >>>>>>> - The >> >>> documentation format: Suggested to use asciidoc. >> >>> >>>>>>> >> >>> >>>>>>> Please, >> >>> read the plan and lets discuss about these 3 topics >> >>> >>>>>>> >> >>> individually. >> >>> >>>>>>> >> >>> >>>>>>> Michelle >> >>> Murray (whose team provided the plan and she is copied >> >>> >>>>>>> on >> >>> >>>>>>> this >> >>> Thread) can follow the feedback. >> >>> >>>>>>> -- >> >>> >>>>>>> *Rafael >> >>> Benevides | Senior Software Engineer* >> >>> >>>>>>> JBoss >> >>> Developer >> >>> >>>>>>> >> >>> M: +55-61-9269-6576 <tel:%2B55-61-9269-6576> >> >>> >>>>>>> >> >>> >>>>>>> Red Hat >> >>> >>>>>>> >> >>> >>>>>>> Better >> >>> technology. Faster innovation. Powered by community >> >>> >>>>>>> >> >>> collaboration. >> >>> >>>>>>> See how it >> >>> works at www.redhat.com <http://www.redhat.com/> >> >>> >>>>>>> >> >>> >>>>>>> LinkedIn >> >>> <http://www.linkedin.com/company/3258288> >> >>> Youtube >> >>> >>>>>>> >> >>> <https://www.youtube.com/redhatlatam> >> >>> >>>>>>> >> >>> >>>>>>> >> >>> >>>>>>> >> >>> >>>>>>> >> >>> > >> >>> >> >>> >> > >