[windup-dev] Asciidoc - lists

Tue Sep 9 10:32:54 EDT 2014

On 09/09/2014 10:18 AM, Pete Muir wrote:
> I took a look at this, and it looks like a problem with the github css for the output. I think you could file a bug with them about it.
I'll file a bug for this.
>
> I guess a good question here is whether the wiki is just for editing, OR if it’s actually how we will present this stuff?
I had originally thought I could reuse the pages to suck the content 
into Drupal, but I now that's unrealistic. At this point I think the 
best approach is the one that is the easiest and the least burden for 
whoever is using it. Ondra produces the most doc, so I'm happy to switch 
back to his preference for Markdown. In the event that we need to go to 
AsciiDoc at any point, there are tools that make the conversion very easy.

>
> On 9 Sep 2014, at 12:45, Sande Gilda <sgilda at redhat.com> wrote:
>
>> 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: https://github.com/windup/windup/wiki
>>
>> 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 [options="compact"], but it didn't seem to work.
>>
>> Ondra, what other issues did you have.
>>
>>
>> On 09/09/2014 06:39 AM, Pete Muir wrote:
>>> 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:
>>> http://redhat.com
>>> [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
>>> <sgilda at redhat.com>
>>>   wrote:
>>>
>>>
>>>> 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:
>>>>
>>>>> 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:
>>>>> bdavis at redhat.com | c: 980.226.7865 | http://www.redhat.com
>>>>>
>>>>>
>>>>>
>>>>> ----- Original Message -----
>>>>> From: "Ondrej Zizka"
>>>>> <ozizka at redhat.com>
>>>>>
>>>>> To: "Sande Gilda"
>>>>> <sgilda at redhat.com>, "Windup-dev List" <windup-dev at lists.jboss.org>
>>>>>
>>>>> 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:
>>>>>
>>>>>> 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:
>>>>>>
>>>>>>> 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:
>>>>>>>
>>>>>>>> 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
>>>>>>>>
>>>>> _______________________________________________
>>>>> windup-dev mailing list
>>>>>
>>>>> windup-dev at lists.jboss.org
>>>>> https://lists.jboss.org/mailman/listinfo/windup-dev
>>>> _______________________________________________
>>>> windup-dev mailing list
>>>>
>>>> windup-dev at lists.jboss.org
>>>> https://lists.jboss.org/mailman/listinfo/windup-dev
>>> _______________________________________________
>>> windup-dev mailing list
>>>
>>> windup-dev at lists.jboss.org
>>> https://lists.jboss.org/mailman/listinfo/windup-dev
>> _______________________________________________
>> windup-dev mailing list
>> windup-dev at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/windup-dev
>
> _______________________________________________
> windup-dev mailing list
> windup-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/windup-dev