Re: [PATCH v2] org-faq.org: Inline comments

[Max Nikulin <manikulin@gmail.com>]

On 08/07/2023 16:31, Ihor Radchenko wrote:
>>> - it is what we use ourselves in WORG sources.

> Max Nikulin writes:
>> I have not found it in the worg repository. There are enough @@html:@@
>> with a handful of @@latex:@@.
> 
> Yeah, not in WORG.
> https://orgmode.org/quickstart.html#text-comments

It makes the FAQ entry having no value if your suggestions are taken 
into account. (I would add a link to annotating that is another sort of 
comments instead of dropping content further.) So I am giving up and 
leaving opportunity to propose changes to somebody else.

The section in quickstart was added in

64922ca 2020-10-04 14:28:00 -0400 Tom Gillespie: quickstart add sections 
for comments and macros at the end

I am surprises that quickstart is more detailed than the manual. However 
I have no idea how to have this section in both documents with proper 
balance in respect to details. Literal copy may be distracting for 
readers familiar with quickstart.

Bing rates quickstart reasonably, but Google avoids it and I have no 
idea why. Some hypotheses:
- quickstart uses generic metadata for the whole site, not specific for 
this page
- <h1> repeating <title> has display:none property
- invalid markup in index.html (a pitfall with affiliated keywords 
breaking paragraphs) for the link to quickstart:

<p>
<a href="quickstart.html">
</p>

<figure id="org490449d">
<img src="resources/img/quickstart.svg" alt="Running stickfigure" 
class="org-svg" title="Start using Org. You'll never stop.">

</figure>

<p>
</a>

I am unsure, but I would expect something like

<a href="quickstart.html" title="Getting started with Org-mode"
    ><img src="resources/img/quickstart.svg" alt="Quickstart"
          class="org-svg"></a>

>> +#+begin_src org
>> +The following line may become a patagraph separator.
>> +@@comment: might give unexpected effect @@
>> +Put some text before @@comment: a better variant
>> +@@ and after instread.
>> +#+end_src
> 
> May you please elaborate?
> If you see inline export block starting a paragraph, it is a bug.

I failed to convince you that it is a general issue, not a LaTeX 
specific one.

Ihor Radchenko to emacs-orgmode… Re: [BUG] No space after footnote with 
org-export-with-footnotes set to nil [9.6.1 ( @ 
/Users/test/.emacs.d/elpa/28.0/develop/org-9.6.1/)] Tue, 14 Mar 2023 
12:19:11 +0000. https://list.orgmode.org/87fsa7o79c.fsf@localhost

try to export to MarkDown. Even for LaTeX the fix is in the development 
branch only. There are enough users of built-in Org that deserve to be 
warned.