Re: Some Asciidoc Tips and Fixes

Sums it up nicely. Bonus, if you go to the '...' dropdown and select 'View file', it looks like everything is rendered correctly. Robert Dale On Fri, Jun 14, 2019 at 7:39 AM Stephen Mallette wrote: > I went ahead an added your tips to the dev docs: > > > https://github.com/apache/tinkerpop/co

Re: Some Asciidoc Tips and Fixes

I went ahead an added your tips to the dev docs: https://github.com/apache/tinkerpop/commit/ddac926ca8f22239e83658ffee65ec2415b3b838 hope that looks ok. On Thu, May 30, 2019 at 8:56 AM Robert Dale wrote: > I haven't added this to the docs yet. As an update to #1, even `__` will > render as a

Re: Some Asciidoc Tips and Fixes

I haven't added this to the docs yet. As an update to #1, even `__` will render as a nested emphasis if there is a following `__` in the same paragraph, i.e. sentences touching, not separated by 2 or more newlines. For example, http://tinkerpop.apache.org/docs/current/reference/ The source is: N

Re: Some Asciidoc Tips and Fixes

eh...looks like those two sections could be better handled. the intent for "Writing Documentation" was to give new contributors some basic instructions as to what was involved in doing that. the "Documentation" section is supposed to be for existing committers. maybe just push the details of of "Wr

Re: Some Asciidoc Tips and Fixes

Should it be there or here http://tinkerpop.apache.org/docs/3.4.1/dev/developer/#_writing_documentation ? Robert Dale On Sat, Mar 30, 2019 at 9:35 AM Stephen Mallette wrote: > interesting - thanks for digging into this. d

Re: Some Asciidoc Tips and Fixes

interesting - thanks for digging into this. do you mind doing a copy/paste/format of these tips to the dev docs so that they aren't lost in the mailing list: http://tinkerpop.apache.org/docs/current/dev/developer/#documentation On Wed, Mar 27, 2019 at 6:23 AM Robert Dale wrote: > 0. Asciidoct

Some Asciidoc Tips and Fixes

0. Asciidoctor is not Asciidoc (applications) This was not immediately obvious to me when I started. I have found that Asciidoc renders the following scenarios correctly. However, our maven build uses Asciidoctor which rendered incorrectly. So if you write asciidoc and use some tool to preview c