Docs - convert java snippets to c#
See original GitHub issueOnce 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:
- Updating Java code examples to C#. Make sure the examples will compile the way they are written after the conversion.
- 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.
- 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.
- 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
andpackage.md
. The rest could probably just use a cursory review.
- src\dotnet\Lucene.Net.Replicator.AspNetCore\examples.md
- src\dotnet\tools\lucene-cli\docs\analysis\index.md
- src\dotnet\tools\lucene-cli\docs\analysis\kuromoji-build-dictionary.md
- src\dotnet\tools\lucene-cli\docs\analysis\stempel-compile-stems.md
- src\dotnet\tools\lucene-cli\docs\analysis\stempel-patch-stems.md
- src\dotnet\tools\lucene-cli\docs\benchmark\extract-reuters.md
- src\dotnet\tools\lucene-cli\docs\benchmark\extract-wikipedia.md
- src\dotnet\tools\lucene-cli\docs\benchmark\find-quality-queries.md
- src\dotnet\tools\lucene-cli\docs\benchmark\index.md
- src\dotnet\tools\lucene-cli\docs\benchmark\run.md
- src\dotnet\tools\lucene-cli\docs\benchmark\run-trec-eval.md
- src\dotnet\tools\lucene-cli\docs\benchmark\sample.md
- src\dotnet\tools\lucene-cli\docs\demo\associations-facets.md
- src\dotnet\tools\lucene-cli\docs\demo\distance-facets.md
- src\dotnet\tools\lucene-cli\docs\demo\expression-aggregation-facets.md
- src\dotnet\tools\lucene-cli\docs\demo\index.md
- src\dotnet\tools\lucene-cli\docs\demo\index-files.md
- src\dotnet\tools\lucene-cli\docs\demo\multi-category-lists-facets.md
- src\dotnet\tools\lucene-cli\docs\demo\range-facets.md
- src\dotnet\tools\lucene-cli\docs\demo\search-files.md
- src\dotnet\tools\lucene-cli\docs\demo\simple-facets.md
- src\dotnet\tools\lucene-cli\docs\demo\simple-sorted-set-facets.md
- src\dotnet\tools\lucene-cli\docs\index.md
- src\dotnet\tools\lucene-cli\docs\index\check.md
- src\dotnet\tools\lucene-cli\docs\index\copy-segments.md
- src\dotnet\tools\lucene-cli\docs\index\delete-segments.md
- src\dotnet\tools\lucene-cli\docs\index\extract-cfs.md
- src\dotnet\tools\lucene-cli\docs\index\fix.md
- src\dotnet\tools\lucene-cli\docs\index\index.md
- src\dotnet\tools\lucene-cli\docs\index\list-cfs.md
- src\dotnet\tools\lucene-cli\docs\index\list-high-freq-terms.md
- src\dotnet\tools\lucene-cli\docs\index\list-segments.md
- src\dotnet\tools\lucene-cli\docs\index\list-taxonomy-stats.md
- src\dotnet\tools\lucene-cli\docs\index\list-term-info.md
- src\dotnet\tools\lucene-cli\docs\index\merge.md
- src\dotnet\tools\lucene-cli\docs\index\split.md
- src\dotnet\tools\lucene-cli\docs\index\upgrade.md
- src\dotnet\tools\lucene-cli\docs\lock\index.md
- src\dotnet\tools\lucene-cli\docs\lock\stress-test.md
- src\dotnet\tools\lucene-cli\docs\lock\verify-server.md
- src\Lucene.Net.Analysis.Common\Analysis\Ar\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Bg\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Br\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Ca\package.md
- src\Lucene.Net.Analysis.Common\Analysis\CharFilter\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Cjk\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Ckb\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Cn\package.md
- src\Lucene.Net.Analysis.Common\Analysis\CommonGrams\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Compound\Hyphenation\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Compound\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Core\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Cz\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Da\package.md
- src\Lucene.Net.Analysis.Common\Analysis\De\package.md
- src\Lucene.Net.Analysis.Common\Analysis\El\package.md
- src\Lucene.Net.Analysis.Common\Analysis\En\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Es\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Eu\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Fa\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Fi\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Fr\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Ga\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Gl\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Hi\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Hu\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Hunspell\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Hy\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Id\package.md
- src\Lucene.Net.Analysis.Common\Analysis\In\package.md
- src\Lucene.Net.Analysis.Common\Analysis\It\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Lv\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Miscellaneous\package.md
- src\Lucene.Net.Analysis.Common\Analysis\NGram\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Nl\package.md
- src\Lucene.Net.Analysis.Common\Analysis\No\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Path\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Pattern\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Payloads\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Position\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Pt\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Query\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Reverse\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Ro\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Ru\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Shingle\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Sinks\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Snowball\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Standard\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Standard\Std31\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Standard\Std34\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Standard\Std36\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Standard\Std40\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Sv\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Synonym\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Th\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Tr\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Util\package.md
- src\Lucene.Net.Analysis.Common\Analysis\Wikipedia\package.md
- src\Lucene.Net.Analysis.Common\Collation\package.md (will fix when ported)
- src\Lucene.Net.Analysis.Common\Collation\TokenAttributes\package.md
- src\Lucene.Net.Analysis.Common\overview.md
- src\Lucene.Net.Analysis.Common\Tartarus\Snowball\Ext\package.md
- src\Lucene.Net.Analysis.Common\Tartarus\Snowball\package.md
- src\Lucene.Net.Analysis.ICU\Analysis\Icu\package.md
- src\Lucene.Net.Analysis.ICU\Analysis\Icu\Segmentation\package.md
- src\Lucene.Net.Analysis.ICU\Analysis\Icu\TokenAttributes\package.md
- src\Lucene.Net.Analysis.ICU\Collation\package.md
- src\Lucene.Net.Analysis.ICU\Collation\TokenAttributes\package.md
- src\Lucene.Net.Analysis.ICU\overview.md
- src\Lucene.Net.Analysis.Kuromoji\Dict\package.md
- src\Lucene.Net.Analysis.Kuromoji\overview.md
- src\Lucene.Net.Analysis.Kuromoji\package.md
- src\Lucene.Net.Analysis.Kuromoji\TokenAttributes\package.md
- src\Lucene.Net.Analysis.Kuromoji\Util\package.md
- src\Lucene.Net.Analysis.Morfologik\overview.md
- src\Lucene.Net.Analysis.Morfologik\package.md
- src\Lucene.Net.Analysis.OpenNLP\overview.md
- src\Lucene.Net.Analysis.Phonetic\overview.md
- src\Lucene.Net.Analysis.Phonetic\package.md
- src\Lucene.Net.Analysis.SmartCn\Hhmm\package.md
- src\Lucene.Net.Analysis.SmartCn\overview.md
- src\Lucene.Net.Analysis.SmartCn\package.md
- src\Lucene.Net.Analysis.Stempel\Egothor.Stemmer\package.md
- src\Lucene.Net.Analysis.Stempel\overview.md
- src\Lucene.Net.Analysis.Stempel\Pl\package.md
- src\Lucene.Net.Analysis.Stempel\Stempel\package.md
- src\Lucene.Net.Benchmark\ByTask\Feeds\package.md
- src\Lucene.Net.Benchmark\ByTask\package.md (tracked in #457)
- src\Lucene.Net.Benchmark\ByTask\Programmatic\package.md
- src\Lucene.Net.Benchmark\ByTask\Stats\package.md
- src\Lucene.Net.Benchmark\ByTask\Tasks\package.md
- src\Lucene.Net.Benchmark\ByTask\Utils\package.md
- src\Lucene.Net.Benchmark\overview.md
- src\Lucene.Net.Benchmark\package.md (tracked in #457)
- src\Lucene.Net.Benchmark\Quality\package.md (tracked in #457)
- src\Lucene.Net.Benchmark\Quality\Trec\package.md
- src\Lucene.Net.Benchmark\Quality\Utils\package.md
- src\Lucene.Net.Benchmark\Utils\package.md
- src\Lucene.Net.Classification\overview.md
- src\Lucene.Net.Classification\package.md
- src\Lucene.Net.Classification\Utils\package.md
- src\Lucene.Net.Codecs\Appending\package.md
- src\Lucene.Net.Codecs\BlockTerms\package.md
- src\Lucene.Net.Codecs\Bloom\package.md
- src\Lucene.Net.Codecs\DiskDV\package.md
- src\Lucene.Net.Codecs\IntBlock\package.md
- src\Lucene.Net.Codecs\Memory\package.md
- src\Lucene.Net.Codecs\overview.md
- src\Lucene.Net.Codecs\Pulsing\package.md
- src\Lucene.Net.Codecs\Sep\package.md
- src\Lucene.Net.Codecs\SimpleText\package.md
- src\Lucene.Net.Demo\Facet\package.md
- src\Lucene.Net.Demo\overview.md (tracked in #457)
- src\Lucene.Net.Demo\package.md
- src\Lucene.Net.Expressions\JS\package.md
- src\Lucene.Net.Expressions\overview.md
- src\Lucene.Net.Expressions\package.md
- src\Lucene.Net.Facet\overview.md (tracked in #457)
- src\Lucene.Net.Facet\package.md
- src\Lucene.Net.Facet\Range\package.md
- src\Lucene.Net.Facet\SortedSet\package.md
- src\Lucene.Net.Facet\Taxonomy\Directory\package.md
- src\Lucene.Net.Facet\Taxonomy\package.md
- src\Lucene.Net.Facet\Taxonomy\WriterCache\package.md
- src\Lucene.Net.Grouping\Function\package.md
- src\Lucene.Net.Grouping\overview.md
- src\Lucene.Net.Grouping\package.md
- src\Lucene.Net.Grouping\Term\package.md
- src\Lucene.Net.Highlighter\Highlight\package.md
- src\Lucene.Net.Highlighter\overview.md
- src\Lucene.Net.Highlighter\PostingsHighlight\package.md
- src\Lucene.Net.Highlighter\VectorHighlight\package.md
- src\Lucene.Net.Join\overview.md
- src\Lucene.Net.Join\package.md
- src\Lucene.Net.Memory\overview.md
- src\Lucene.Net.Memory\package.md
- src\Lucene.Net.Misc\Document\package.md
- src\Lucene.Net.Misc\Index\package.md
- src\Lucene.Net.Misc\Index\Sorter\package.md
- src\Lucene.Net.Misc\Misc\package.md
- src\Lucene.Net.Misc\overview.md
- src\Lucene.Net.Misc\Store\package.md
- src\Lucene.Net.Misc\Util\Fst\package.md
- src\Lucene.Net.Queries\Function\DocValues\package.md
- src\Lucene.Net.Queries\Function\package.md
- src\Lucene.Net.Queries\Function\ValueSources\package.md
- src\Lucene.Net.Queries\Mlt\package.md
- src\Lucene.Net.Queries\overview.md
- src\Lucene.Net.Queries\package.md
- src\Lucene.Net.QueryParser\Analyzing\package.md
- src\Lucene.Net.QueryParser\Classic\package.md
- src\Lucene.Net.QueryParser\ComplexPhrase\package.md
- src\Lucene.Net.QueryParser\Ext\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\Builders\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\Config\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\Messages\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\Nodes\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\Parser\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\Processors\package.md
- src\Lucene.Net.QueryParser\Flexible\Core\Util\package.md
- src\Lucene.Net.QueryParser\Flexible\Messages\package.md
- src\Lucene.Net.QueryParser\Flexible\Precedence\package.md
- src\Lucene.Net.QueryParser\Flexible\Precedence\Processors\package.md
- src\Lucene.Net.QueryParser\Flexible\Standard\Builders\package.md
- src\Lucene.Net.QueryParser\Flexible\Standard\Config\package.md
- src\Lucene.Net.QueryParser\Flexible\Standard\Nodes\package.md
- src\Lucene.Net.QueryParser\Flexible\Standard\package.md
- src\Lucene.Net.QueryParser\Flexible\Standard\Parser\package.md
- src\Lucene.Net.QueryParser\Flexible\Standard\Processors\package.md
- src\Lucene.Net.QueryParser\overview.md
- src\Lucene.Net.QueryParser\Simple\package.md
- src\Lucene.Net.QueryParser\Surround\Parser\package.md
- src\Lucene.Net.QueryParser\Surround\Query\package.md
- src\Lucene.Net.QueryParser\Xml\Builders\package.md
- src\Lucene.Net.QueryParser\Xml\package.md
- src\Lucene.Net.Replicator\Http\package.md
- src\Lucene.Net.Replicator\Http\replicator.md
- src\Lucene.Net.Replicator\overview.md
- src\Lucene.Net.Replicator\package.md
- src\Lucene.Net.Sandbox\overview.md
- src\Lucene.Net.Sandbox\Queries\package.md
- src\Lucene.Net.Spatial\overview.md
- src\Lucene.Net.Spatial\package.md
- src\Lucene.Net.Spatial\Prefix\package.md
- src\Lucene.Net.Spatial\Prefix\Tree\package.md
- src\Lucene.Net.Spatial\Query\package.md
- src\Lucene.Net.Spatial\Serialized\package.md
- src\Lucene.Net.Spatial\Util\package.md
- src\Lucene.Net.Spatial\Vector\package.md
- src\Lucene.Net.Suggest\overview.md
- src\Lucene.Net.Suggest\Spell\package.md
- src\Lucene.Net.Suggest\Suggest\Analyzing\package.md
- src\Lucene.Net.Suggest\Suggest\Fst\package.md
- src\Lucene.Net.Suggest\Suggest\Jaspell\package.md
- src\Lucene.Net.Suggest\Suggest\package.md
- src\Lucene.Net.Suggest\Suggest\Tst\package.md
- src\Lucene.Net.TestFramework\Analysis\package.md
- src\Lucene.Net.TestFramework\Codecs\Asserting\package.md
- src\Lucene.Net.TestFramework\Codecs\Bloom\package.md
- src\Lucene.Net.TestFramework\Codecs\CheapBastard\package.md
- src\Lucene.Net.TestFramework\Codecs\Compressing\Dummy\package.md
- src\Lucene.Net.TestFramework\Codecs\Compressing\package.md
- src\Lucene.Net.TestFramework\Codecs\Lucene3x\package.md
- src\Lucene.Net.TestFramework\Codecs\Lucene40\package.md
- src\Lucene.Net.TestFramework\Codecs\Lucene41\package.md
- src\Lucene.Net.TestFramework\Codecs\Lucene41Ords\package.md
- src\Lucene.Net.TestFramework\Codecs\Lucene42\package.md
- src\Lucene.Net.TestFramework\Codecs\Lucene45\package.md
- src\Lucene.Net.TestFramework\Codecs\MockIntBlock\package.md
- src\Lucene.Net.TestFramework\Codecs\MockRandom\package.md
- src\Lucene.Net.TestFramework\Codecs\MockSep\package.md
- src\Lucene.Net.TestFramework\Codecs\NestedPulsing\package.md
- src\Lucene.Net.TestFramework\Codecs\package.md
- src\Lucene.Net.TestFramework\Codecs\RAMOnly\package.md
- src\Lucene.Net.TestFramework\Index\package.md
- src\Lucene.Net.TestFramework\overview.md
- src\Lucene.Net.TestFramework\Search\package.md
- src\Lucene.Net.TestFramework\Store\package.md
- src\Lucene.Net.TestFramework\Util\Automaton\package.md
- src\Lucene.Net.TestFramework\Util\Fst\package.md
- src\Lucene.Net.TestFramework\Util\package.md
- src\Lucene.Net\Analysis\package.md
- src\Lucene.Net\Analysis\TokenAttributes\package.md
- src\Lucene.Net\Codecs\Compressing\package.md
- src\Lucene.Net\Codecs\Lucene3x\package.md
- src\Lucene.Net\Codecs\Lucene40\package.md
- src\Lucene.Net\Codecs\Lucene41\package.md
- src\Lucene.Net\Codecs\Lucene42\package.md
- src\Lucene.Net\Codecs\Lucene45\package.md
- src\Lucene.Net\Codecs\Lucene46\package.md
- src\Lucene.Net\Codecs\package.md
- src\Lucene.Net\Codecs\PerField\package.md
- src\Lucene.Net\Document\package.md
- src\Lucene.Net\Index\package.md
- src\Lucene.Net\migration-guide.md
- src\Lucene.Net\overview.md
- src\Lucene.Net\package.md
- src\Lucene.Net\Search\package.md
- src\Lucene.Net\Search\Payloads\package.md
- src\Lucene.Net\Search\Similarities\package.md
- src\Lucene.Net\Search\Spans\package.md
- src\Lucene.Net\Store\package.md
- src\Lucene.Net\Util\Automaton\package.md
- src\Lucene.Net\Util\Fst\package.md
- src\Lucene.Net\Util\Mutable\package.md
- src\Lucene.Net\Util\package.md
- src\Lucene.Net\Util\Packed\package.md
- websites\apidocs\apiSpec\core\Lucene_Net_Codecs.md
- websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_AssociationsFacetsExample.md (tracked in #457)
- websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_DistanceFacetsExample.md (tracked in #457)
- websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_ExpressionAggregationFacetsExample.md (tracked in #457)
- websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_MultiCategoryListsFacetsExample.md (tracked in #457)
- websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_RangeFacetsExample.md (tracked in #457)
- websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_SimpleFacetsExample.md (tracked in #457)
- websites\apidocs\apiSpec\demo\Lucene_Net_Demo_Facet_SimpleSortedSetFacetsExample.md (tracked in #457)
- websites\apidocs\index.md
Issue Analytics
- State:
- Created 3 years ago
- Comments:8 (6 by maintainers)
Top Results From Across the Web
How to convert Java code snippet into C# - Stack Overflow
I'm struggling to understand how to convert this Java code into a C# one. Any help is greatly appreciated. public enum Direction {...
Read more >Easily format and display code in Google Docs
End users: To format and display code in a Doc, select Insert > Building blocks > Code blocks > choose your programming language...
Read more >Snippets in Visual Studio Code
Snippets in Visual Studio Code. Code snippets are templates that make it easier to enter repeating code patterns, such as loops or conditional-statements....
Read more >Paste and Convert Code Snippets with Oxidizer - Elements Docs
Paste and Convert Code Snippets with Oxidizer ... Simply copy a piece of C#, Objective-C, Java, Swift or Delphi code from an existing...
Read more >2 Snippets - Java
JShell accepts Java statements; variable, method, and class definitions; imports; and expressions. These pieces of Java code are referred to as snippets.
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
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).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:
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.
@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:
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:
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.