<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">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 href="mailto:ozizka@redhat.com">ozizka@redhat.com</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
<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 class="moz-cite-prefix">On 9.9.2014 13:45, Sande Gilda wrote:<br>
</div>
<blockquote cite="mid:540EE847.9010507@redhat.com" type="cite">
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
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" class="moz-txt-link-freetext" href="https://github.com/windup/windup/wiki">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 class="moz-cite-prefix">On 09/09/2014 06:39 AM, Pete Muir
wrote:<br>
</div>
<blockquote cite="mid:C25BCFE3-C0E5-4269-8566-989A4D87013D@redhat.com" type="cite">
<pre wrap="">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" class="moz-txt-link-freetext" href="http://redhat.com/">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" class="moz-txt-link-rfc2396E" href="mailto:sgilda@redhat.com"><sgilda@redhat.com></a> wrote:
</pre>
<blockquote type="cite">
<pre wrap="">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 wrap="">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" class="moz-txt-link-abbreviated" href="mailto:bdavis@redhat.com">bdavis@redhat.com</a> | c: 980.226.7865 | <a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://www.redhat.com/">http://www.redhat.com</a>
----- Original Message -----
From: "Ondrej Zizka" <a moz-do-not-send="true" class="moz-txt-link-rfc2396E" href="mailto:ozizka@redhat.com"><ozizka@redhat.com></a>
To: "Sande Gilda" <a moz-do-not-send="true" class="moz-txt-link-rfc2396E" href="mailto:sgilda@redhat.com"><sgilda@redhat.com></a>, "Windup-dev List" <a moz-do-not-send="true" class="moz-txt-link-rfc2396E" href="mailto:windup-dev@lists.jboss.org"><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 wrap="">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 wrap="">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 wrap="">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 wrap="">_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:windup-dev@lists.jboss.org">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" 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>
<pre wrap="">_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:windup-dev@lists.jboss.org">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" 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>
<pre wrap="">_______________________________________________
windup-dev mailing list
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:windup-dev@lists.jboss.org">windup-dev@lists.jboss.org</a>
<a moz-do-not-send="true" 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>
<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>
</div>
_______________________________________________<br>windup-dev mailing list<br><a href="mailto:windup-dev@lists.jboss.org">windup-dev@lists.jboss.org</a><br>https://lists.jboss.org/mailman/listinfo/windup-dev</blockquote></div><br></div></body></html>