You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucenenet.apache.org by GitBox <gi...@apache.org> on 2021/03/30 15:04:51 UTC

[GitHub] [lucenenet] Shazwazza opened a new issue #284: Docs - convert java snippets to c#

Shazwazza opened a new issue #284:
URL: https://github.com/apache/lucenenet/issues/284


   > Requires: https://github.com/apache/lucenenet/issues/283
   
   > Once we have an idea about how this works https://github.com/apache/lucenenet/issues/283 we can start the snippet conversion. This could be broken down into smaller tasks and listed as up for grabs.
   
   > _~15 hrs_
   
   ---------------------------------------------------------------------------------------
   
   This issue no longer depends on #283, since that issue was addressed by #396. So this issue is no longer blocked.
   
   Here is a list of all of the documentation files that will require a review to update code examples. Note that links are a different issue that is being worked on in #300. So in this issue, we should focus on:
   
   1. Updating Java code examples to C#. Make sure the examples will compile the way they are written after the conversion.
   2. Updating references to Java technologies (types, JVM, class path, etc) to their .NET equivalents. Some of this will require some research. Note that some things like links over to Java-related wikipedia articles are probably best to leave alone and other things like types that exist in Java but don't in .NET and are still required to make the flow of the docs work might need to be clarified for the average .NET developer.
   3. Make sure the formatting of the Markdown document is similar to how it was in Lucene - that is, make sure the numbered and unordered lists come up correctly, tables are legible, etc.
   3. Look out for issues with API usability and open issues about them if any are found.
   
   > **NOTE:** The main documents to focus on here are named `overview.md` and `package.md`. The rest could probably just use a cursory review.
   
   - [x] [src\dotnet\Lucene.Net.Replicator.AspNetCore\examples.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/Lucene.Net.Replicator.AspNetCore/examples.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\analysis\index.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/analysis/index.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\analysis\kuromoji-build-dictionary.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/analysis/kuromoji-build-dictionary.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\analysis\stempel-compile-stems.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/analysis/stempel-compile-stems.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\analysis\stempel-patch-stems.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/analysis/stempel-patch-stems.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\benchmark\extract-reuters.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/benchmark/extract-reuters.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\benchmark\extract-wikipedia.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/benchmark/extract-wikipedia.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\benchmark\find-quality-queries.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/benchmark/find-quality-queries.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\benchmark\index.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/benchmark/index.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\benchmark\run.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/benchmark/run.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\benchmark\run-trec-eval.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/benchmark/run-trec-eval.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\benchmark\sample.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/benchmark/sample.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\associations-facets.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/associations-facets.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\distance-facets.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/distance-facets.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\expression-aggregation-facets.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/expression-aggregation-facets.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\index.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/index.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\index-files.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/index-files.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\multi-category-lists-facets.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/multi-category-lists-facets.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\range-facets.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/range-facets.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\search-files.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/search-files.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\simple-facets.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/simple-facets.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\demo\simple-sorted-set-facets.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/demo/simple-sorted-set-facets.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\check.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/check.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\copy-segments.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/copy-segments.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\delete-segments.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/delete-segments.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\extract-cfs.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/extract-cfs.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\fix.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/fix.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\index.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/index.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\list-cfs.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/list-cfs.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\list-high-freq-terms.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/list-high-freq-terms.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\list-segments.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/list-segments.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\list-taxonomy-stats.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/list-taxonomy-stats.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\list-term-info.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/list-term-info.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\merge.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/merge.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\split.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/split.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\index\upgrade.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/index/upgrade.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\lock\index.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/lock/index.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\lock\stress-test.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/lock/stress-test.md)
   - [x] [src\dotnet\tools\lucene-cli\docs\lock\verify-server.md](https://github.com/apache/lucenenet/tree/master/src/dotnet/tools/lucene-cli/docs/lock/verify-server.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Ar\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Ar/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Bg\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Bg/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Br\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Br/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Ca\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Ca/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\CharFilter\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/CharFilter/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Cjk\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Cjk/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Ckb\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Ckb/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Cn\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Cn/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\CommonGrams\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/CommonGrams/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Compound\Hyphenation\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Compound/Hyphenation/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Compound\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Compound/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Core\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Core/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Cz\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Cz/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Da\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Da/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\De\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/De/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\El\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/El/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\En\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/En/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Es\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Es/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Eu\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Eu/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Fa\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Fa/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Fi\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Fi/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Fr\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Fr/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Ga\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Ga/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Gl\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Gl/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Hi\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Hi/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Hu\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Hu/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Hunspell\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Hunspell/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Hy\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Hy/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Id\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Id/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\In\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/In/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\It\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/It/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Lv\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Lv/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Miscellaneous\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Miscellaneous/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\NGram\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/NGram/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Nl\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Nl/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\No\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/No/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Path\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Path/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Pattern\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Pattern/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Payloads\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Payloads/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Position\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Position/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Pt\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Pt/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Query\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Query/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Reverse\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Reverse/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Ro\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Ro/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Ru\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Ru/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Shingle\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Shingle/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Sinks\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Sinks/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Snowball\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Snowball/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Standard\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Standard/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Standard\Std31\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Standard/Std31/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Standard\Std34\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Standard/Std34/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Standard\Std36\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Standard/Std36/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Standard\Std40\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Standard/Std40/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Sv\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Sv/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Synonym\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Synonym/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Th\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Th/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Tr\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Tr/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Util\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Util/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Analysis\Wikipedia\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Analysis/Wikipedia/package.md)
   - [ ] [src\Lucene.Net.Analysis.Common\Collation\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Collation/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Collation\TokenAttributes\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Collation/TokenAttributes/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/overview.md)
   - [x] [src\Lucene.Net.Analysis.Common\Tartarus\Snowball\Ext\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Tartarus/Snowball/Ext/package.md)
   - [x] [src\Lucene.Net.Analysis.Common\Tartarus\Snowball\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Common/Tartarus/Snowball/package.md)
   - [x] [src\Lucene.Net.Analysis.ICU\Analysis\Icu\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.ICU/Analysis/Icu/package.md)
   - [x] [src\Lucene.Net.Analysis.ICU\Analysis\Icu\Segmentation\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.ICU/Analysis/Icu/Segmentation/package.md)
   - [x] [src\Lucene.Net.Analysis.ICU\Analysis\Icu\TokenAttributes\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.ICU/Analysis/Icu/TokenAttributes/package.md)
   - [x] [src\Lucene.Net.Analysis.ICU\Collation\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.ICU/Collation/package.md)
   - [x] [src\Lucene.Net.Analysis.ICU\Collation\TokenAttributes\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.ICU/Collation/TokenAttributes/package.md)
   - [x] [src\Lucene.Net.Analysis.ICU\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.ICU/overview.md)
   - [x] [src\Lucene.Net.Analysis.Kuromoji\Dict\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Kuromoji/Dict/package.md)
   - [x] [src\Lucene.Net.Analysis.Kuromoji\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Kuromoji/overview.md)
   - [x] [src\Lucene.Net.Analysis.Kuromoji\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Kuromoji/package.md)
   - [x] [src\Lucene.Net.Analysis.Kuromoji\TokenAttributes\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Kuromoji/TokenAttributes/package.md)
   - [x] [src\Lucene.Net.Analysis.Kuromoji\Util\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Kuromoji/Util/package.md)
   - [x] [src\Lucene.Net.Analysis.Morfologik\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Morfologik/overview.md)
   - [x] [src\Lucene.Net.Analysis.Morfologik\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Morfologik/package.md)
   - [x] [src\Lucene.Net.Analysis.OpenNLP\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.OpenNLP/overview.md)
   - [x] [src\Lucene.Net.Analysis.Phonetic\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Phonetic/overview.md)
   - [x] [src\Lucene.Net.Analysis.Phonetic\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Phonetic/package.md)
   - [x] [src\Lucene.Net.Analysis.SmartCn\Hhmm\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.SmartCn/Hhmm/package.md)
   - [x] [src\Lucene.Net.Analysis.SmartCn\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.SmartCn/overview.md)
   - [x] [src\Lucene.Net.Analysis.SmartCn\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.SmartCn/package.md)
   - [x] [src\Lucene.Net.Analysis.Stempel\Egothor.Stemmer\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Stempel/Egothor.Stemmer/package.md)
   - [x] [src\Lucene.Net.Analysis.Stempel\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Stempel/overview.md)
   - [x] [src\Lucene.Net.Analysis.Stempel\Pl\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Stempel/Pl/package.md)
   - [x] [src\Lucene.Net.Analysis.Stempel\Stempel\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Analysis.Stempel/Stempel/package.md)
   - [x] [src\Lucene.Net.Benchmark\ByTask\Feeds\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/ByTask/Feeds/package.md)
   - [ ] [src\Lucene.Net.Benchmark\ByTask\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/ByTask/package.md)
   - [x] [src\Lucene.Net.Benchmark\ByTask\Programmatic\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/ByTask/Programmatic/package.md)
   - [x] [src\Lucene.Net.Benchmark\ByTask\Stats\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/ByTask/Stats/package.md)
   - [x] [src\Lucene.Net.Benchmark\ByTask\Tasks\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/ByTask/Tasks/package.md)
   - [x] [src\Lucene.Net.Benchmark\ByTask\Utils\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/ByTask/Utils/package.md)
   - [x] [src\Lucene.Net.Benchmark\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/overview.md)
   - [ ] [src\Lucene.Net.Benchmark\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/package.md)
   - [ ] [src\Lucene.Net.Benchmark\Quality\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/Quality/package.md)
   - [x] [src\Lucene.Net.Benchmark\Quality\Trec\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/Quality/Trec/package.md)
   - [x] [src\Lucene.Net.Benchmark\Quality\Utils\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/Quality/Utils/package.md)
   - [x] [src\Lucene.Net.Benchmark\Utils\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Benchmark/Utils/package.md)
   - [x] [src\Lucene.Net.Classification\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Classification/overview.md)
   - [x] [src\Lucene.Net.Classification\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Classification/package.md)
   - [x] [src\Lucene.Net.Classification\Utils\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Classification/Utils/package.md)
   - [x] [src\Lucene.Net.Codecs\Appending\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/Appending/package.md)
   - [x] [src\Lucene.Net.Codecs\BlockTerms\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/BlockTerms/package.md)
   - [x] [src\Lucene.Net.Codecs\Bloom\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/Bloom/package.md)
   - [x] [src\Lucene.Net.Codecs\DiskDV\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/DiskDV/package.md)
   - [x] [src\Lucene.Net.Codecs\IntBlock\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/IntBlock/package.md)
   - [x] [src\Lucene.Net.Codecs\Memory\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/Memory/package.md)
   - [x] [src\Lucene.Net.Codecs\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/overview.md)
   - [x] [src\Lucene.Net.Codecs\Pulsing\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/Pulsing/package.md)
   - [x] [src\Lucene.Net.Codecs\Sep\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/Sep/package.md)
   - [x] [src\Lucene.Net.Codecs\SimpleText\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Codecs/SimpleText/package.md)
   - [x] [src\Lucene.Net.Demo\Facet\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Demo/Facet/package.md)
   - [ ] [src\Lucene.Net.Demo\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Demo/overview.md)
   - [x] [src\Lucene.Net.Demo\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Demo/package.md)
   - [x] [src\Lucene.Net.Expressions\JS\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Expressions/JS/package.md)
   - [x] [src\Lucene.Net.Expressions\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Expressions/overview.md)
   - [x] [src\Lucene.Net.Expressions\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Expressions/package.md)
   - [ ] [src\Lucene.Net.Facet\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Facet/overview.md)
   - [x] [src\Lucene.Net.Facet\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Facet/package.md)
   - [x] [src\Lucene.Net.Facet\Range\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Facet/Range/package.md)
   - [x] [src\Lucene.Net.Facet\SortedSet\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Facet/SortedSet/package.md)
   - [x] [src\Lucene.Net.Facet\Taxonomy\Directory\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Facet/Taxonomy/Directory/package.md)
   - [x] [src\Lucene.Net.Facet\Taxonomy\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Facet/Taxonomy/package.md)
   - [x] [src\Lucene.Net.Facet\Taxonomy\WriterCache\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Facet/Taxonomy/WriterCache/package.md)
   - [x] [src\Lucene.Net.Grouping\Function\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Grouping/Function/package.md)
   - [x] [src\Lucene.Net.Grouping\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Grouping/overview.md)
   - [x] [src\Lucene.Net.Grouping\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Grouping/package.md)
   - [x] [src\Lucene.Net.Grouping\Term\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Grouping/Term/package.md)
   - [x] [src\Lucene.Net.Highlighter\Highlight\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Highlighter/Highlight/package.md)
   - [x] [src\Lucene.Net.Highlighter\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Highlighter/overview.md)
   - [x] [src\Lucene.Net.Highlighter\PostingsHighlight\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Highlighter/PostingsHighlight/package.md)
   - [x] [src\Lucene.Net.Highlighter\VectorHighlight\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Highlighter/VectorHighlight/package.md)
   - [x] [src\Lucene.Net.Join\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Join/overview.md)
   - [x] [src\Lucene.Net.Join\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Join/package.md)
   - [x] [src\Lucene.Net.Memory\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Memory/overview.md)
   - [x] [src\Lucene.Net.Memory\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Memory/package.md)
   - [x] [src\Lucene.Net.Misc\Document\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Misc/Document/package.md)
   - [x] [src\Lucene.Net.Misc\Index\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Misc/Index/package.md)
   - [x] [src\Lucene.Net.Misc\Index\Sorter\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Misc/Index/Sorter/package.md)
   - [x] [src\Lucene.Net.Misc\Misc\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Misc/Misc/package.md)
   - [x] [src\Lucene.Net.Misc\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Misc/overview.md)
   - [x] [src\Lucene.Net.Misc\Store\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Misc/Store/package.md)
   - [x] [src\Lucene.Net.Misc\Util\Fst\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Misc/Util/Fst/package.md)
   - [x] [src\Lucene.Net.Queries\Function\DocValues\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Queries/Function/DocValues/package.md)
   - [x] [src\Lucene.Net.Queries\Function\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Queries/Function/package.md)
   - [x] [src\Lucene.Net.Queries\Function\ValueSources\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Queries/Function/ValueSources/package.md)
   - [x] [src\Lucene.Net.Queries\Mlt\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Queries/Mlt/package.md)
   - [x] [src\Lucene.Net.Queries\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Queries/overview.md)
   - [x] [src\Lucene.Net.Queries\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Queries/package.md)
   - [x] [src\Lucene.Net.QueryParser\Analyzing\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Analyzing/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Classic\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Classic/package.md)
   - [x] [src\Lucene.Net.QueryParser\ComplexPhrase\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/ComplexPhrase/package.md)
   - [x] [src\Lucene.Net.QueryParser\Ext\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Ext/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\Builders\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/Builders/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\Config\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/Config/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\Messages\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/Messages/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\Nodes\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/Nodes/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\Parser\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/Parser/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\Processors\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/Processors/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Core\Util\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Core/Util/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Messages\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Messages/package.md)
   - [x] [src\Lucene.Net.QueryParser\Flexible\Precedence\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Precedence/package.md)
   - [x] [src\Lucene.Net.QueryParser\Flexible\Precedence\Processors\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Precedence/Processors/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Standard\Builders\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Standard/Builders/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Standard\Config\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Standard/Config/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Standard\Nodes\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Standard/Nodes/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Standard\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Standard/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Standard\Parser\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Standard/Parser/package.md)
   - [ ] [src\Lucene.Net.QueryParser\Flexible\Standard\Processors\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Flexible/Standard/Processors/package.md)
   - [ ] [src\Lucene.Net.QueryParser\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/overview.md)
   - [ ] [src\Lucene.Net.QueryParser\Simple\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Simple/package.md)
   - [x] [src\Lucene.Net.QueryParser\Surround\Parser\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Surround/Parser/package.md)
   - [x] [src\Lucene.Net.QueryParser\Surround\Query\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Surround/Query/package.md)
   - [x] [src\Lucene.Net.QueryParser\Xml\Builders\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Xml/Builders/package.md)
   - [x] [src\Lucene.Net.QueryParser\Xml\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.QueryParser/Xml/package.md)
   - [ ] [src\Lucene.Net.Replicator\Http\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Replicator/Http/package.md)
   - [x] [src\Lucene.Net.Replicator\Http\replicator.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Replicator/Http/replicator.md)
   - [x] [src\Lucene.Net.Replicator\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Replicator/overview.md)
   - [ ] [src\Lucene.Net.Replicator\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Replicator/package.md)
   - [x] [src\Lucene.Net.Sandbox\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Sandbox/overview.md)
   - [x] [src\Lucene.Net.Sandbox\Queries\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Sandbox/Queries/package.md)
   - [x] [src\Lucene.Net.Spatial\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/overview.md)
   - [x] [src\Lucene.Net.Spatial\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/package.md)
   - [x] [src\Lucene.Net.Spatial\Prefix\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/Prefix/package.md)
   - [x] [src\Lucene.Net.Spatial\Prefix\Tree\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/Prefix/Tree/package.md)
   - [x] [src\Lucene.Net.Spatial\Query\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/Query/package.md)
   - [x] [src\Lucene.Net.Spatial\Serialized\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/Serialized/package.md)
   - [x] [src\Lucene.Net.Spatial\Util\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/Util/package.md)
   - [x] [src\Lucene.Net.Spatial\Vector\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Spatial/Vector/package.md)
   - [x] [src\Lucene.Net.Suggest\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Suggest/overview.md)
   - [x] [src\Lucene.Net.Suggest\Spell\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Suggest/Spell/package.md)
   - [x] [src\Lucene.Net.Suggest\Suggest\Analyzing\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Suggest/Suggest/Analyzing/package.md)
   - [x] [src\Lucene.Net.Suggest\Suggest\Fst\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Suggest/Suggest/Fst/package.md)
   - [x] [src\Lucene.Net.Suggest\Suggest\Jaspell\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Suggest/Suggest/Jaspell/package.md)
   - [x] [src\Lucene.Net.Suggest\Suggest\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Suggest/Suggest/package.md)
   - [x] [src\Lucene.Net.Suggest\Suggest\Tst\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.Suggest/Suggest/Tst/package.md)
   - [x] [src\Lucene.Net.TestFramework\Analysis\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Analysis/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Asserting\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Asserting/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Bloom\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Bloom/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\CheapBastard\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/CheapBastard/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Compressing\Dummy\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Compressing/Dummy/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Compressing\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Compressing/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Lucene3x\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Lucene3x/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Lucene40\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Lucene40/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Lucene41\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Lucene41/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Lucene41Ords\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Lucene41Ords/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Lucene42\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Lucene42/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\Lucene45\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/Lucene45/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\MockIntBlock\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/MockIntBlock/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\MockRandom\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/MockRandom/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\MockSep\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/MockSep/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\NestedPulsing\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/NestedPulsing/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/package.md)
   - [x] [src\Lucene.Net.TestFramework\Codecs\RAMOnly\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Codecs/RAMOnly/package.md)
   - [x] [src\Lucene.Net.TestFramework\Index\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Index/package.md)
   - [x] [src\Lucene.Net.TestFramework\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/overview.md)
   - [x] [src\Lucene.Net.TestFramework\Search\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Search/package.md)
   - [x] [src\Lucene.Net.TestFramework\Store\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Store/package.md)
   - [x] [src\Lucene.Net.TestFramework\Util\Automaton\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Util/Automaton/package.md)
   - [x] [src\Lucene.Net.TestFramework\Util\Fst\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Util/Fst/package.md)
   - [x] [src\Lucene.Net.TestFramework\Util\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net.TestFramework/Util/package.md)
   - [x] [src\Lucene.Net\Analysis\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Analysis/package.md)
   - [x] [src\Lucene.Net\Analysis\TokenAttributes\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Analysis/TokenAttributes/package.md)
   - [x] [src\Lucene.Net\Codecs\Compressing\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/Compressing/package.md)
   - [x] [src\Lucene.Net\Codecs\Lucene3x\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/Lucene3x/package.md)
   - [x] [src\Lucene.Net\Codecs\Lucene40\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/Lucene40/package.md)
   - [x] [src\Lucene.Net\Codecs\Lucene41\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/Lucene41/package.md)
   - [x] [src\Lucene.Net\Codecs\Lucene42\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/Lucene42/package.md)
   - [x] [src\Lucene.Net\Codecs\Lucene45\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/Lucene45/package.md)
   - [x] [src\Lucene.Net\Codecs\Lucene46\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/Lucene46/package.md)
   - [x] [src\Lucene.Net\Codecs\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/package.md)
   - [x] [src\Lucene.Net\Codecs\PerField\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Codecs/PerField/package.md)
   - [x] [src\Lucene.Net\Document\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Document/package.md)
   - [x] [src\Lucene.Net\Index\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Index/package.md)
   - [x] [src\Lucene.Net\migration-guide.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/migration-guide.md)
   - [x] [src\Lucene.Net\overview.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/overview.md)
   - [x] [src\Lucene.Net\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/package.md)
   - [x] [src\Lucene.Net\Search\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Search/package.md)
   - [x] [src\Lucene.Net\Search\Payloads\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Search/Payloads/package.md)
   - [x] [src\Lucene.Net\Search\Similarities\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Search/Similarities/package.md)
   - [x] [src\Lucene.Net\Search\Spans\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Search/Spans/package.md)
   - [x] [src\Lucene.Net\Store\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Store/package.md)
   - [x] [src\Lucene.Net\Util\Automaton\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Util/Automaton/package.md)
   - [x] [src\Lucene.Net\Util\Fst\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Util/Fst/package.md)
   - [x] [src\Lucene.Net\Util\Mutable\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Util/Mutable/package.md)
   - [x] [src\Lucene.Net\Util\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Util/package.md)
   - [x] [src\Lucene.Net\Util\Packed\package.md](https://github.com/apache/lucenenet/tree/master/src/Lucene.Net/Util/Packed/package.md)
   - [x] [websites\apidocs\apiSpec\core\Lucene_Net_Codecs.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/core/Lucene_Net_Codecs.md)
   - [ ] [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_AssociationsFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_AssociationsFacetsExample.md)
   - [ ] [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_DistanceFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_DistanceFacetsExample.md)
   - [ ] [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_ExpressionAggregationFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_ExpressionAggregationFacetsExample.md)
   - [ ] [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_MultiCategoryListsFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_MultiCategoryListsFacetsExample.md)
   - [ ] [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_RangeFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_RangeFacetsExample.md)
   - [ ] [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_SimpleFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_SimpleFacetsExample.md)
   - [ ] [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_SimpleSortedSetFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_SimpleSortedSetFacetsExample.md)
   - [x] [websites\apidocs\index.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/index.md)


-- 
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.

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



[GitHub] [lucenenet] NightOwl888 commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-667698917


   @rclabo - Thanks for the kind words and support. As you might have noticed, I have changed my tune a little. We totally understand if people don't have the kind of bandwidth it takes to contribute, especially being that there is a bit of a learning curve before a contribution can even begin. In fact, when I lived in the U.S., I couldn't imagine how anyone could find the time to do open source work. But if that is indeed the case, we ask that those people show their support by making a small monetary contribution instead. We'd rather see this project crowdfunded by several hundred parties than have one or two companies carry the whole load on their backs, anyway.
   
   https://github.com/sponsors/NightOwl888
   https://github.com/sponsors/Shazwazza
   
   


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] mikeren2014 commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
mikeren2014 commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-667153497


   Thanks so much for your response. @NightOwl888 
   
   > > Anyone knows which Java version the latest Lucene.Net maps to?
   > 
   > >>Lucene 4.8.0 supports Java 4, 5, and 6.
   
   Sorry, I mean the Java Lucene version. I am seeing that the latest Java Lucene is 8.6.0. Does Lucene.Net 4.8.0 match Lucene 4.8.0? I am asking because I cannot believe it falls behind so much. 
   
   > > And why Lucene.Net has no stable version released for such a long time?
   > 
   >>> Quite simply, because there haven't been enough people contributing, and we only recently got any sponsorship. 
   
   I didn't know that there are so few people contributing for such a complicated project. Thank you so much for your effort on this! I  hope you can find more contributors. This is really a wonderful project for .net developers. Hoping that it is going well.


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] NightOwl888 commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-667202834


   > Sorry, I mean the Java Lucene version. I am seeing that the latest Java Lucene is 8.6.0. Does Lucene.Net 4.8.0 match Lucene 4.8.0?
   
   The core Lucene.Net project is based on 4.8.0. Most of the submodules including `Lucene.Net.Analyisis.Common` are based on 4.8.1. Some of the other analysis modules were ported from 7.2.0 and 8.2.0 (which were the latest at the time we ported them).
   
   > I am asking because I cannot believe it falls behind so much.
   
   That is the battle we are fighting. People get the impression that we are far behind because of the number of years it has taken and the fact there are 4 major versions between Lucene.NET and Lucene.
   
   Last I checked (I believe it was 8.3.0), there were exactly 7 new modules and about 12 new features of any consequence added since 4.8.0. That's it. Look at the source code if you don't believe it. There was a discussion back in 2018 that I wasn't part of where some people said they are withholding their support because we are not targeting the latest version. I am curious to know whether they realize:
   
   - Lucene.NET 4.8.0 is almost stable and has been since that conversation happened in 2018
   - We have been working on Lucene.NET's dependencies since then (that both 4.8.0 and 8.x require)
   - It would take around 1800 hours to upgrade from 4.8.0 to 8.x, not including the 1100-1200 hours we have yet to complete now
   - Changing gears now will rob the .NET community of a stable Lucene.NET 4.8.0 in 2021, and take at least an extra year to stabilize and roll out
   - We are planning to upgrade to 8.x after the release of Lucene.NET 4.8.0 is stable and we have secured enough funding to get started
   - 8.x has only about 12 new features that 4.8.0 doesn't have that are of any consequence
   
   I am curious to know which of the 12 or so new features that people think are so important that they are withholding their support, and how they could ever think it would be worth it for us to derail the whole project for at least a year to try to reach that goal. Not to mention robbing the entire .NET community of a stable 4.8.0 while they wait for that work to be completed.
   
   Our sponsors at Microsoft doesn't agree with those people. They don't even agree with us that it is worth it to upgrade to 8.x after the release of 4.8.0. Sure there are bug fixes and performance benefits in the new version, but the total benefit for the cost just isn't there.
   
   Unfortunately the gap between the reality of the situation and the impression that people get about how far we are behind is a big one, and that situation isn't going to change until we either reach a stable 4.8.0 or the community provides enough funding for the extra 1800 hours of labor involved in re-targeting to 8.2.0.
   
   


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] NightOwl888 closed issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 closed issue #284:
URL: https://github.com/apache/lucenenet/issues/284


   


-- 
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.

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



[GitHub] [lucenenet] rclabo commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
rclabo commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-668023250


   @NightOwl888 - I think that's also a great approach.  If we could get a large community supporting the project with small monetary contributions that would be awesome.  Still, I also think we need to get more devs coding and supporting the project with their skills.  I truly hope to be a part of that down the road.


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] mikeren2014 commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
mikeren2014 commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-666463512


   Anyone knows which Java version the latest Lucene.Net maps to?
   
   And why Lucene.Net has no stable version released for such a long time?


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] NightOwl888 commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-666915768


   > Anyone knows which Java version the latest Lucene.Net maps to?
   
   Lucene 4.8.0 supports Java 4, 5, and 6.
   
   > And why Lucene.Net has no stable version released for such a long time?
   
   Quite simply, because there haven't been enough people contributing, and we only recently got any sponsorship. There has been 5000+ hours contributed since 2014 on Lucene.NET 4.8.0, of which I have personally contributed about 4000 hours. Lucene.NET was pretty much ported in 2017, but we are now trying to finish up all of the dependencies that didn't exist in .NET (namely [ICU4N](https://github.com/NightOwl888/ICU4N) and [J2N](https://github.com/NightOwl888/J2N)), testing on different platforms and operating systems, and implement enough of the features of the test framework that we can be reasonably sure that we aren't getting false positives. There is also some research to do to work out how to implement some of the features properly on the .NET platform, quite a bit of cleanup work of the APIs, and more performance tuning to do. Not to mention chasing down bug reports and answering user inquiries that we could use help with.
   
   There are around 1100-1200 hours of work left to complete Lucene.NET 4.8.0 to production with its dependencies. Microsoft has recently sponsored 200 hours, and is considering more funding. We are also getting some funding from iTextSharp. But, for a project of this size and complexity we are going to need more contributions, more funding, or both to see this through to the point it is enterprise-ready.
   
   For anyone interested in sponsoring the project, either do so through our personal GitHub sponsors accounts or contact me via the email address on my profile and I will provide details on how to sponsor the project as a whole. Or, if you would like to make a contribution, do note that anything marked `up-for-grabs` is free for anyone to start working on - simply leave a message on the issue and we will assign it to you.
   
   
   


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] NightOwl888 edited a comment on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 edited a comment on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-667202834


   > Sorry, I mean the Java Lucene version. I am seeing that the latest Java Lucene is 8.6.0. Does Lucene.Net 4.8.0 match Lucene 4.8.0?
   
   The core Lucene.Net project is based on 4.8.0. Most of the submodules including `Lucene.Net.Analyisis.Common` are based on 4.8.1. Some of the other analysis modules were ported from 7.2.0 and 8.2.0 (which were the latest at the time we ported them).
   
   > I am asking because I cannot believe it falls behind so much.
   
   That is the battle we are fighting. People get the impression that we are far behind because of the number of years it has taken and the fact there are 4 major versions between Lucene.NET and Lucene.
   
   Last I checked (I believe it was 8.3.0), there were exactly 7 new modules and about 12 new features of any consequence added since 4.8.0. That's it. Look at the source code if you don't believe it. There was a discussion back in 2018 that I wasn't part of where some people said they are withholding their support because we are not targeting the latest version. I am curious to know whether they realize:
   
   - Lucene.NET 4.8.0 is almost stable and has been since that conversation happened in 2018
   - We have been working on Lucene.NET's dependencies since then (that both 4.8.0 and 8.x require)
   - It would take around 1800 hours to upgrade from 4.8.0 to 8.x, not including the 1100-1200 hours we have yet to complete now
   - Changing gears now will rob the .NET community of a stable Lucene.NET 4.8.0 in 2021, and take at least an extra year to stabilize and roll out
   - We are planning to upgrade to 8.x after the release of Lucene.NET 4.8.0 is stable and we have secured enough funding to get started
   - 8.x has only about 12 new features that 4.8.0 doesn't have that are of any consequence
   
   I am curious to know which of the 12 or so new features that people think are so important that they are withholding their support, and how they could ever think it would be worth it for us to derail the whole project for at least a year to try to reach that goal. Not to mention robbing the entire .NET community of a stable 4.8.0 while they wait for that work to be completed.
   
   Our sponsors at Microsoft doesn't agree with those people. They don't even agree with us that it is worth it to upgrade to 8.x after the release of 4.8.0. Sure there are bug fixes and performance benefits in the new version, but the total benefit for the cost just isn't there.
   
   Unfortunately the gap between the reality of the situation and the impression that people get about how far we are behind is a big one, and that situation isn't going to change until we either reach a stable 4.8.0 or the community provides enough funding for the extra 1800 hours of labor involved in re-targeting to 8.x.
   
   


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] NightOwl888 edited a comment on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 edited a comment on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-667202834


   > Sorry, I mean the Java Lucene version. I am seeing that the latest Java Lucene is 8.6.0. Does Lucene.Net 4.8.0 match Lucene 4.8.0?
   
   The core Lucene.Net project is based on 4.8.0. Most of the submodules including `Lucene.Net.Analysis.Common` are based on 4.8.1. Some of the other analysis modules were ported from 7.2.0 and 8.2.0 (which were the latest at the time we ported them).
   
   > I am asking because I cannot believe it falls behind so much.
   
   That is the battle we are fighting. People get the impression that we are far behind because of the number of years it has taken and the fact there are 4 major versions between Lucene.NET and Lucene.
   
   Last I checked (I believe it was 8.3.0), there were exactly 7 new modules and about 12 new features of any consequence added since 4.8.0. That's it. Look at the source code if you don't believe it. There was a discussion back in 2018 that I wasn't part of where some people said they are withholding their support because we are not targeting the latest version. I am curious to know whether they realize:
   
   - Lucene.NET 4.8.0 is almost stable and has been since that conversation happened in 2018
   - We have been working on Lucene.NET's dependencies since then (that both 4.8.0 and 8.x require)
   - It would take around 1800 hours to upgrade from 4.8.0 to 8.x, not including the 1100-1200 hours we have yet to complete now
   - Changing gears now will rob the .NET community of a stable Lucene.NET 4.8.0 in 2021, and take at least an extra year to stabilize and roll out
   - We are planning to upgrade to 8.x after the release of Lucene.NET 4.8.0 is stable and we have secured enough funding to get started
   - 8.x has only about 12 new features that 4.8.0 doesn't have that are of any consequence
   
   I am also curious to know which of the 12 or so new features that people think are so important that they are withholding their support, and how they could ever think it would be worth it for us to derail the whole project for at least a year to try to reach that goal. Not to mention robbing the entire .NET community of a stable 4.8.0 while they wait for that work to be completed.
   
   Our sponsors at Microsoft don't agree with those people. They don't even agree with us that it is worth it to upgrade to 8.x after the release of 4.8.0. Sure there are bug fixes and performance benefits in the new version, but the total benefit for the cost just isn't there.
   
   Unfortunately the gap between the reality of the situation and the impression that people get about how far we are behind is a big one, and that situation isn't going to change until we either reach a stable 4.8.0 or the community provides enough funding for the extra 1800 hours of labor involved in re-targeting to 8.x.
   
   


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] rclabo commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
rclabo commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-667322958


   @NightOwl888 Thank you for this response and succinct comparison of 4.8 vs 8.3 as well as highlighting the gap between perception and reality with regard to the differences between those to versions.  This is enlightening to me and explains a lot.  The strategy of getting 4.8 released before working towards the latest version makes perfect sense.  I truly wish I had some bandwidth to help contribute.  In the future I hope to get myself to a position where I can.  In my mind, there is no more worthy open source project in the .Net ecosystem then Lucene.Net to warrant developer contributions.  This code base and the functionality it provides is truly impressive.


----------------------------------------------------------------
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.

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



[GitHub] [lucenenet] NightOwl888 closed issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 closed issue #284:
URL: https://github.com/apache/lucenenet/issues/284


   


-- 
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.

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



[GitHub] [lucenenet] NightOwl888 commented on issue #284: Docs - convert java snippets to c#

Posted by GitBox <gi...@apache.org>.
NightOwl888 commented on issue #284:
URL: https://github.com/apache/lucenenet/issues/284#issuecomment-806268971


   @Shazwazza
   
   I have generated a list of the Markdown documents and tailored it to the API docs that we should review for this issue.
   
   However, in the process I noticed that we have demo examples that have been copied into the docs:
   
   - [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_AssociationsFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_AssociationsFacetsExample.md)
   - [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_DistanceFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_DistanceFacetsExample.md)
   - [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_ExpressionAggregationFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_ExpressionAggregationFacetsExample.md)
   - [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_MultiCategoryListsFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_MultiCategoryListsFacetsExample.md)
   - [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_RangeFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_RangeFacetsExample.md)
   - [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_SimpleFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_SimpleFacetsExample.md)
   - [websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_SimpleSortedSetFacetsExample.md](https://github.com/apache/lucenenet/tree/master/websites/apidocs/apiSpec/demo/Lucene_Net_Demo_Facet_SimpleSortedSetFacetsExample.md)
   
   
   I don't know specifically how often we are going to need to update the demos, but having duplicate copies of them doesn't seem like a good idea maintenance-wise. And if we are going to copy them, we are missing the 2 main ones that are [linked from the main "core" overview page](https://lucene.apache.org/core/4_8_0/core/overview-summary.html):
   
   - [IndexFiles.cs](https://github.com/apache/lucenenet/blob/Lucene.Net_4_8_0_beta00013/src/Lucene.Net.Demo/IndexFiles.cs)
   - [SearchFiles.cs](https://github.com/apache/lucenenet/blob/Lucene.Net_4_8_0_beta00013/src/Lucene.Net.Demo/SearchFiles.cs)
   
   Is there some reason why we need to duplicate this code into documents? Ideally, our docs would link to the state of these files at the tag of the release so we wouldn't have extra documents to maintain when the code changes.
   
   Also, where are these documents linked from on the website? I couldn't find any references to them.


-- 
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.

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