Re: [I] Use @snippet javadoc tag for snippets [lucene]

[via GitHub]

rmuir commented on issue #14257:
URL: https://github.com/apache/lucene/issues/14257#issuecomment-2667192244

   The markdown would have a huge advantage for the many analyzers with 
xml-style prettyprint docs today. I don't think `@snippet` works with languages 
other than java.
   
   For me, editor displays the current "prettyprint" of analyzers XML docs 
without any syntax highlighting:
   
   
![Image](https://github.com/user-attachments/assets/77a56890-7bd8-4f61-9bb1-7ee159bd5591)
   
   On the other hand, with markdown you'd get this:
   ```xml
   <fieldType name="text_arnormal" class="solr.TextField" 
positionIncrementGap="100">
     <analyzer>
       <tokenizer class="solr.StandardTokenizerFactory"/>
       <filter class="solr.ArabicNormalizationFilterFactory"/>
     </analyzer>
   </fieldType>
   ```


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org