Great work!

On Thu, Aug 28, 2014 at 11:03 AM, Rafael Benevides <benevi...@redhat.com>
wrote:

> I believe that the work for the asciidoc documentation is ready!
>
> Please, check this generated asciidcotor page:
> http://deltaspike.apache.org/documentation/container-control-test.html
>
> The branch with the source code is here: https://github.com/rafabene/
> deltaspike/tree/documentation/documentation
>
>
> Em 8/27/14, 18:14, Rafael Benevides escreveu:
>
>  Yeap. I have to agree with you.
>>
>> So I've changed my strategy...
>>
>> I've taken your PoC and made some minor modifications and place it on my
>> branch: https://github.com/rafabene/deltaspike/tree/documentation/
>> documentation
>>
>> Note that I'm using the agreed path for documentation folder and that I
>> also included a Readme.md that instructs how to setup the credentials on
>> ~/.m2/settings.xml and what maven command that should be used to deploy.
>>
>> The result was published here: http://deltaspike.apache.org/
>> documentation/container-control-test.html
>>
>> What is missing now is the generated html template/styles.
>>
>>
>> Em 8/27/14, 17:23, John D. Ament escreveu:
>>
>>> IMHO, the current approach is a bit safer and more testable.  running
>>> mvn site will generate the asciidoc.  That would be a bit harder to do if
>>> we need to support running it as a part of a staging pull.
>>>
>>>
>>> On Wed, Aug 27, 2014 at 4:14 PM, Rafael Benevides <benevi...@redhat.com
>>> <mailto:benevi...@redhat.com>> wrote:
>>>
>>>     I was trying to avoid two steps to deploy:
>>>
>>>     1 - mvn site-deploy on git repo to copy it to the CMS staging are
>>>     2 - CMS deploy to publish it
>>>
>>>     But I think that should not be a problem, Right?
>>>
>>>     So what I'll do now, based on your PoC is to make the templates of
>>>     the generated html to be close to deltaspike site style.
>>>
>>>     Em 8/27/14, 17:10, John D. Ament escreveu:
>>>
>>>>     Rafael,
>>>>
>>>>     This shouldn't be needed any longer.  Based on what I did, we can
>>>>     now do a mvn site-deploy to copy everything into the CMS staging
>>>>     area.  Once verified go into CMS and do a publish.
>>>>
>>>>     John
>>>>
>>>>
>>>>     On Wed, Aug 27, 2014 at 3:57 PM, Rafael Benevides
>>>>     <benevi...@redhat.com <mailto:benevi...@redhat.com>> wrote:
>>>>
>>>>         Hi all,
>>>>
>>>>         This email is just to give a feedback about making CMS to
>>>>         work with Github and Asciidoc.
>>>>
>>>>         Finally  I was able to understand enough how CMS works and
>>>>         probably I'm stopped where John Ament was.
>>>>
>>>>         What I'm doing now is writing a GitUtil Perl Module that will
>>>>         be hosted at
>>>> http://svn.apache.org/repos/asf/deltaspike/site/trunk/lib/
>>>>         that will be responsible for cloning the documentation (on
>>>>         deltaspike git repo) and then another module will run the
>>>>         build (asciidoc to html) just for [<git_root>/documentation/].
>>>>
>>>>         The idea is that the final documentation gets hosted at
>>>>         deltaspike.apache.org/documentation/
>>>>         <http://deltaspike.apache.org/documentation/> (note the sub
>>>>         folder).
>>>>
>>>>         Further steps: Prepare a template so asciidoc generated html
>>>>         uses the same style of deltaspike.apache.org
>>>>         <http://deltaspike.apache.org>.
>>>>
>>>>         Well, the idea here is to make everyone aware about this and
>>>>         also say that if is there anybody if Perl knowledge, you're
>>>>         welcome to give some hints!
>>>>
>>>>         Thanks
>>>>
>>>>
>>>>         --
>>>>         *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>
>>>>
>>>>
>>>>
>>>
>>>
>>
>>
>


-- 
Jason Porter
http://en.gravatar.com/lightguardjp

Reply via email to