paulirwin commented on code in PR #1:
URL: 
https://github.com/apache/lucenenet-codeanalysis-dev/pull/1#discussion_r1990004571


##########
src/Lucene.Net.CodeAnalysis.Dev/AnalyzerReleases.Unshipped.md:
##########
@@ -0,0 +1,9 @@
+### New Rules

Review Comment:
   I'll work on the rest, but in regard to "It looks like you meant to use 
[Microsoft.CodeAnalysis.PublicApiAnalyzers](https://github.com/%5Bdotnet/roslyn-analyzers%5D(https://github.com/dotnet/roslyn-analyzers?tab=readme-ov-file#microsoftcodeanalysispublicapianalyzers)?tab=readme-ov-file#microsoftcodeanalysispublicapianalyzers)"
 - nope, Microsoft.CodeAnalysis.Analyzers is a different package that provides 
meta-analyzers that make sure you're creating analyzers properly. That is a 
different package than PublicApiAnalyzers, which is for analyzing changes to 
your public APIs. Microsoft.CodeAnalysis.Analyzers reads in these Markdown 
files and expects them to be in the specific format per the docs that you 
linked to.
   
   I do not think we need Microsoft.CodeAnalysis.PublicApiAnalyzers as this is 
not a public API per se like Roslyn analyzers are (per your example link). That 
could be useful on the main lucenenet project (including our public analyzers), 
though.
   
   Re: the docs, I think we should just link to those docs in the README, not 
copy the docs here. That way if they improve the docs or fix documentation bugs 
there, we don't have to keep our version in sync.



-- 
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: dev-unsubscr...@lucenenet.apache.org

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

Reply via email to