<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#FFFFFF">
Hi Lincoln,<br>
<br>
The plan is definitely to make them all Asciidoc format. Ondra
writes a lot of doc and if he feels more productive using Markdown
when creating a new document, that's fine by me. When he's finished
with a topic, I will convert it to Asciidoc. Then he will have to
make any updates using the Asciidoc format. So everything will be
Asciidoc.<br>
<br>
Thanks,<br>
Sande<br>
<br>
<div class="moz-cite-prefix">On 09/12/2014 11:30 AM, Lincoln Baxter,
III wrote:<br>
</div>
<blockquote
cite="mid:CAEp_U4H_fc3c4kiRzCnyqjfCZefO476Zf29bWA=o8Dmah9twQQ@mail.gmail.com"
type="cite">
<div dir="ltr">Coming in to this late, I'd prefer to stick with
one format, and it seems like we (as JBoss) are moving toward
asciidoc, so I think we should stick with that (for all of the
previously stated reasons.)</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On Thu, Sep 11, 2014 at 7:13 AM, Sande
Gilda <span dir="ltr"><<a moz-do-not-send="true"
href="mailto:sgilda@redhat.com" target="_blank">sgilda@redhat.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
<div text="#000000" bgcolor="#FFFFFF"> Hi Ondra,<br>
<br>
Of course! As I said on IRC, what ever is easiest for you
is fine by me. :-)<br>
<br>
Thanks,<br>
Sande
<div>
<div class="h5"><br>
<br>
<div>On 09/10/2014 11:04 PM, Ondrej Zizka wrote:<br>
</div>
<blockquote type="cite"> Okay, in that case, let's do
AsciiDoc, except for the few pages where I am just
storing temp info before converting to a real page,
mostly "Dev:", because that's changing often,
shouldn't go to any official docs, and I edit faster
in Markdown. These pages will have "Draft" at the
top. But I'll update the existing pages in AsciiDoc.<br>
<br>
Will that work fine?<br>
<br>
Regards,<br>
Ondra<br>
<br>
<br>
<br>
<div>On 10.9.2014 13:44, Sande Gilda wrote:<br>
</div>
<blockquote type="cite"> Coming into this late....<br>
<br>
I agree with Pete. I think the Wiki is a temporary
container for the documentation. As Pete said, we
may embed the docs into the web site or it may be
published to the Customer Portal. Similar to the
other documentation, we may also eventually need
more complex structures like tables and graphs and
I'm pretty sure we will want to publish PDFs. I
hate to tie ourselves to something that can't grow
with us. The syntax for AsciiDoc is very similar
and I don't find it any more difficult to work
with than Markdown.<br>
<br>
I do think we need to be consistent with the
documentation and use the same tooling for all the
pages. However, Ondra, if you feel more
comfortable and productive working with Markdown,
please continue to use it as you are doing an
amazing job creating documentation! When you think
a page is ready, I am happy to convert it to
AsciiDoc for you. :-)<br>
<br>
<div>On 09/10/2014 06:12 AM, Pete Muir wrote:<br>
</div>
<blockquote type="cite"> I doubt that the github
wiki will be our target output platform. We’ll
likely want to embed them in to the website.
<div><br>
<div>
<div>On 9 Sep 2014, at 23:24, Ondrej Zizka
<<a moz-do-not-send="true"
href="mailto:ozizka@redhat.com"
target="_blank">ozizka@redhat.com</a>>
wrote:</div>
<br>
<blockquote type="cite">
<div bgcolor="#FFFFFF" text="#000000">
Other issues might be GitHub's
translator. But IDK what's the main
target medium for our docs. Is that
GitHub wiki?<br>
<br>
Ondra<br>
<br>
<br>
<div>On 9.9.2014 13:45, Sande Gilda
wrote:<br>
</div>
<blockquote type="cite"> One of Ondra's
complaints is the way lists seem to
display an extra paragraph between the
items. Take a look at the home page
here: <a moz-do-not-send="true"
href="https://github.com/windup/windup/wiki"
target="_blank">https://github.com/windup/windup/wiki</a><br>
<br>
Note that the list items are spaced
far apart. I search for a solution,
and the only thing I could find was
mention of using <code>[options="compact"],
</code>but it didn't seem to work.<br>
<br>
Ondra, what other issues did you have.
<br>
<br>
<br>
<div>On 09/09/2014 06:39 AM, Pete Muir
wrote:<br>
</div>
<blockquote type="cite">
<pre>The big advantages of asciidoc are:
* more comprehensive markup (e.g. tables, definition lists are supported as standard)
* generation of pdf and epub is part of the standard toolchain
Markdown is great for short docs, but I quickly ran in to the limitations when building more complex documents.
GitHub’s support for asciidoc wasn’t great to start with, but I think the fixed it more recently. Before you abandon it, point me at the problems, I can take a quick look.
I prefer asciidoc links as you just do link:<a moz-do-not-send="true" href="http://redhat.com/" target="_blank">http://redhat.com</a>[Red Hat’s website]. I find this much easier to remember than the weird []() syntax in markdown.
On 9 Sep 2014, at 01:23, Sande Gilda <a moz-do-not-send="true" href="mailto:sgilda@redhat.com" target="_blank"><sgilda@redhat.com></a> wrote:
</pre>
<blockquote type="cite">
<pre>I'll change everything back to Markdown later this week. Ondra, in the
meantime, you can work in Markdown.
On 09/08/2014 08:12 PM, Brad Davis wrote:
</pre>
<blockquote type="cite">
<pre>I personally leveraged Markdown because it worked. Asciidoc a while ago did not. I noticed when things moved to Asciidoc, the images in the docs broke.
Brad Davis
Red Hat Consulting
Email: <a moz-do-not-send="true" href="mailto:bdavis@redhat.com" target="_blank">bdavis@redhat.com</a> | c: <a moz-do-not-send="true" href="tel:980.226.7865" value="+19802267865" target="_blank">980.226.7865</a> | <a moz-do-not-send="true" href="http://www.redhat.com/" target="_blank">http://www.redhat.com</a>
----- Original Message -----
From: "Ondrej Zizka" <a moz-do-not-send="true" href="mailto:ozizka@redhat.com" target="_blank"><ozizka@redhat.com></a>
To: "Sande Gilda" <a moz-do-not-send="true" href="mailto:sgilda@redhat.com" target="_blank"><sgilda@redhat.com></a>, "Windup-dev List" <a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank"><windup-dev@lists.jboss.org></a>
Sent: Monday, September 8, 2014 7:58:20 PM
Subject: Re: [windup-dev] Asciidoc - lists
For the record: I don't strongly prefer either, only that I only touched
few things in AsciiDoc, and:
1) certain constructs are quite less readable -> editable in the
source text (e.g. links)
2) the render results are not satisfactory - things like a bold text
in a lists are not properly implemented on whatever GitHub uses.
Ondra
On 9.9.2014 01:17, Sande Gilda wrote:
</pre>
<blockquote type="cite">
<pre>Hi all,
Ondra asked me about the advantages of AsciiDoc over Markdown. I
really don't know, but I do remember Pete saying AsciiDoc would be
better for the quickstart README files long ago. And I believe Drupal,
the new host for documentation, supports AsciiDoc.
TBH, I don't feel strongly about sticking with AsciiDoc. If no one can
come up with a good reason for sticking with it, I'm fine with going
back to Markdown if it's easier for everyone.
So, AsciiDoc advocates, please speak up now.
Thanks,
Sande
On 09/08/2014 06:29 PM, Sande Gilda wrote:
</pre>
<blockquote type="cite">
<pre>Hi Ondra,
You're asking me? ;-)
I'm totally new to asciidoc. I'll research it and see what I can find
out.
Thanks,
Sande
On 09/08/2014 06:13 PM, Ondrej Zizka wrote:
</pre>
<blockquote type="cite">
<pre>Hi Sande,
is there any way to prevent asciidoc put <p> to each <li>? Makes the
list tall and breaks the whole page layout.
Thanks,
Ondra
</pre>
</blockquote>
</blockquote>
</blockquote>
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a>
</pre>
</blockquote>
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a>
</pre>
</blockquote>
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a>
</pre>
</blockquote>
<br>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a></pre>
</blockquote>
<br>
</div>
_______________________________________________<br>
windup-dev mailing list<br>
<a moz-do-not-send="true"
href="mailto:windup-dev@lists.jboss.org"
target="_blank">windup-dev@lists.jboss.org</a><br>
<a moz-do-not-send="true"
href="https://lists.jboss.org/mailman/listinfo/windup-dev"
target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a></blockquote>
</div>
<br>
</div>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a></pre>
</blockquote>
<br>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a></pre>
</blockquote>
<br>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" href="mailto:windup-dev@lists.jboss.org" target="_blank">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" href="https://lists.jboss.org/mailman/listinfo/windup-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a></pre>
</blockquote>
<br>
</div>
</div>
</div>
<br>
_______________________________________________<br>
windup-dev mailing list<br>
<a moz-do-not-send="true"
href="mailto:windup-dev@lists.jboss.org">windup-dev@lists.jboss.org</a><br>
<a moz-do-not-send="true"
href="https://lists.jboss.org/mailman/listinfo/windup-dev"
target="_blank">https://lists.jboss.org/mailman/listinfo/windup-dev</a><br>
</blockquote>
</div>
<br>
<br clear="all">
<div><br>
</div>
-- <br>
Lincoln Baxter, III<br>
<a moz-do-not-send="true" href="http://ocpsoft.org"
target="_blank">http://ocpsoft.org</a><br>
"Simpler is better."
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
windup-dev mailing list
<a class="moz-txt-link-abbreviated" href="mailto:windup-dev@lists.jboss.org">windup-dev@lists.jboss.org</a>
<a class="moz-txt-link-freetext" href="https://lists.jboss.org/mailman/listinfo/windup-dev">https://lists.jboss.org/mailman/listinfo/windup-dev</a></pre>
</blockquote>
<br>
</body>
</html>