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>
