This is an automated email from the ASF dual-hosted git repository.
shazwazza pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/lucenenet-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 818cd85 updates for community links and maillist
818cd85 is described below
commit 818cd85a4fc83ce12b37c1d63d223e3c58f8cbfa
Author: Shannon <[email protected]>
AuthorDate: Thu Oct 8 17:30:59 2020 +1100
updates for community links and maillist
---
contributing/{index.html => community-links.html} | 75 ++++++++++++++---------
contributing/index.html | 2 +
contributing/mailing-lists.html | 26 +++++---
contributing/toc.html | 3 +
manifest.json | 60 ++++++++++--------
xrefmap.yml | 3 +
6 files changed, 108 insertions(+), 61 deletions(-)
diff --git a/contributing/index.html b/contributing/community-links.html
similarity index 54%
copy from contributing/index.html
copy to contributing/community-links.html
index 3bf051c..e292e93 100644
--- a/contributing/index.html
+++ b/contributing/community-links.html
@@ -5,9 +5,9 @@
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
- <title>Lucene.Net project contributing guide | Apache Lucene.NET 4.8.0
</title>
+ <title>Community Links | Apache Lucene.NET 4.8.0 </title>
<meta name="viewport" content="width=device-width">
- <meta name="title" content="Lucene.Net project contributing guide | Apache
Lucene.NET 4.8.0 ">
+ <meta name="title" content="Community Links | Apache Lucene.NET 4.8.0 ">
<meta name="generator" content="docfx 2.50.0.0">
<link rel="shortcut icon" href="../logo/favicon.ico">
@@ -70,33 +70,52 @@
</div>
<div class="article row grid-right">
<div class="col-md-10">
- <article class="content wrap" id="_content"
data-uid="contributing">
-<h1 id="lucenenet-project-contributing-guide">Lucene.Net project contributing
guide</h1>
+ <article class="content wrap" id="_content"
data-uid="contributing/community-links">
+<h1 id="community-links">Community Links</h1>
<hr>
-<h2 id="getting-involved">Getting involved</h2>
-<p><em>There are lots ways to help contribute to the Lucene.Net
project!</em></p>
-<p>Lucene.Net is a very large project (over 400,000 executable lines of code
and nearly 1,000,000 lines of text total) and we welcome any and all help to
maintain such an effort.</p>
-<h3 id="ask-a-question">Ask a Question</h3>
-<p>If you have a general how-to question or need help from the Lucene.Net
community, please email the Apache Lucene.Net-User mailing list by sending a
message to:</p>
-<p><a href="mailto:[email protected]";>[email protected]</a></p>
-<p>We recommend you join the <a
href="https://cwiki.apache.org/confluence/display/LUCENENET/Mailing+Lists";>user
mailing list</a> to stay looped into all user discussions.</p>
-<p>Alternatively, you can get help via <a
href="https://stackoverflow.com/questions/tagged/lucene.net";>StackOverflow</a>.</p>
-<p>Please do not submit general how-to questions to GitHub, use GitHub Issues
for bug reports and tasks only.</p>
-<p>see <strong><a class="xref" href="mailing-lists.html">mailing
lists</a></strong></p>
-<h3 id="start-a-discussion">Start a Discussion</h3>
-<p>To start a development discussion regarding technical features of
Lucene.Net, please email the Apache Lucene.Net-Developer mailing list by
sending a message to:</p>
-<p><a href="mailto:[email protected]";>[email protected]</a></p>
-<p>We recommend you join both the <a
href="https://cwiki.apache.org/confluence/display/LUCENENET/Mailing+Lists";>user
and dev mailing lists</a> to stay looped in to all user and developer
discussions.</p>
-<p>see <strong><a class="xref" href="mailing-lists.html">mailing
lists</a></strong></p>
-<h3 id="website-and-documentation">Website and Documentation</h3>
-<p>Help with keeping this website and documentation up to date would be a
great help. It would be great to migrate/consolidate a lot of the important
information from the wiki to this website. See <strong><a class="xref"
href="documentation.html">website and documentation</a></strong> for more
information about contributing to this area.</p>
-<h3 id="report-a-bug">Report a Bug</h3>
-<p>To report a bug, please use the <a class="xref"
href="issue-tracker.html">GitHub issue tracker</a>.</p>
-<h3 id="submit-a-pull-request">Submit a Pull Request</h3>
-<p>First have a look at the <strong><a class="xref"
href="current-status.html">Current Status</a></strong> of the project to see
where things are at.</p>
-<p>There's a <a
href="https://github.com/apache/lucenenet/blob/master/CONTRIBUTING.md";>detailed
contribution guide here</a>. <em>(it would be good to migrate this guide to
this website)</em></p>
-<p>And another guide is here about all the basics of getting started with the
repo and how we prefer to receive pull requests <a
href="https://cwiki.apache.org/confluence/display/LUCENENET/Git+Setup+and+Pull+Requests";>Git
Setup and Pull Requests</a></p>
+<h2 id="blog-posts">Blog Posts</h2>
+<p>Here are some great posts from the Lucene.Net community:</p>
+<h3 id="full-text-search-with-lucenenet"><a
href="https://www.elbisch.ch/2019/05/31/full-text-search-for-database-entities-with-lucene-net/";>Full
Text Search with Lucene.Net</a></h3>
+<p>A very detailed how-to guide for working with Lucene.Net.</p>
+<blockquote>
+<p>"This is one of the best posts I have ever seen about
Lucene.NET"</p>
+</blockquote>
+<h3 id="introductory-lucenenet-series">Introductory Lucene.Net Series</h3>
+<p>An excellent introductory series from <a
href="http://codeclimber.net.nz/";>Simone Chiaretta</a></p>
+<ul>
+<li><a
href="http://codeclimber.net.nz/archive/2009/08/27/how-to-get-started-with-lucene.net.aspx";>How
to get started with Lucene.Net</a></li>
+<li><a
href="http://codeclimber.net.nz/archive/2009/08/31/lucene.net-the-main-concepts.aspx";>The
Main Concepts</a></li>
+<li><a
href="http://codeclimber.net.nz/archive/2009/09/02/lucene.net-your-first-application.aspx";>Your
First Application</a></li>
+<li><a
href="http://codeclimber.net.nz/archive/2009/09/04/dissecting-lucene.net-storage-documents-and-fields.aspx";>Dissecting
Storage Documents and Fields</a></li>
+<li><a
href="http://codeclimber.net.nz/archive/2009/09/08/lucene-or-how-i-stopped-worrying-and-learned-to.aspx";>Lucene
- or how I stopped worrying and learned to love unstructured data</a></li>
+<li><a
href="http://codeclimber.net.nz/archive/2009/09/10/how-subtext-lucene.net-index-is-structured.aspx";>How
Subtext Lucene.Net index is structured</a></li>
+</ul>
+<h3 id="other-posts">Other posts</h3>
+<ul>
+<li><a
href="https://shazwazza.com/post/how-to-set-rewrite-method-on-queries-lazily-in-lucene/";>Lazily
setting the SetMultiTermRewriteMethod</a>
+<ul>
+<li>How-to guide on lazily setting the rewrite method of the query parser
instead of eagerly since you may not know it is required until the query is
built.</li>
+</ul>
+</li>
+<li><a
href="https://shazwazza.com/post/spatial-search-with-examine-and-lucene/";>Spatial
Search with Lucene.Net and Examine</a>
+<ul>
+<li>How-to guide on implementing geo spatial search with Lucene.Net in the
context of using <a href="https://github.com/shazwazza/examine";>Examine</a> to
manage Lucene.Net.</li>
+</ul>
+</li>
+<li><a
href="https://www.aaron-powell.com/posts/2019-11-29-implementing-search-in-blazor-webassembly-with-lucenenet/";>Implementing
Search in Blazor WebAssembly with Lucene.Net</a>
+<ul>
+<li>How-to guide on setting up Lucene.Net to work with <a
href="https://docs.microsoft.com/en-gb/aspnet/core/blazor/?view=aspnetcore-3.0&WT.mc_id=aaronpowell-blog-aapowell#blazor-webassembly";>Blazor
WebAssembly</a>.</li>
+</ul>
+</li>
+</ul>
+<h2 id="lucenenet-projects">Lucene.Net projects</h2>
+<p>Here are some great projects built with Lucene.Net:</p>
+<h3 id="examine"><a
href="https://github.com/shazwazza/examine";>Examine</a></h3>
+<p>Examine is a managed abstraction around Lucene.Net. It provides a fluent
search API and handles all of the underlying Lucene.Net objects for you.</p>
+<h3 id="azure-directory"><a
href="https://github.com/azure-contrib/AzureDirectory";>Azure Directory</a></h3>
+<p>This project allows you to create Lucene Indexes and use them in Azure.</p>
+<p>This project implements a low level Lucene Directory object called
AzureDirectory around Windows Azure BlobStorage.</p>
</article>
</div>
@@ -105,7 +124,7 @@
<div class="contribution">
<ul class="nav">
<li>
- <a
href="https://github.com/apache/lucenenet/blob/master/websites/site/contributing/index.md/#L1";
class="contribution-link">Improve this Doc</a>
+ <a
href="https://github.com/apache/lucenenet/blob/master/websites/site/contributing/community-links.md/#L1";
class="contribution-link">Improve this Doc</a>
</li>
</ul>
</div>
diff --git a/contributing/index.html b/contributing/index.html
index 3bf051c..5b541f4 100644
--- a/contributing/index.html
+++ b/contributing/index.html
@@ -77,6 +77,8 @@
<h2 id="getting-involved">Getting involved</h2>
<p><em>There are lots ways to help contribute to the Lucene.Net
project!</em></p>
<p>Lucene.Net is a very large project (over 400,000 executable lines of code
and nearly 1,000,000 lines of text total) and we welcome any and all help to
maintain such an effort.</p>
+<h3 id="write-a-blog-post">Write a blog post</h3>
+<p>Community written blog posts and projects based on Lucene.Net are a
wonderful way to be involved with the Lucene.Net project. We can even feature
your work on the <a class="xref" href="community-links.html">Community Links
Page</a>.</p>
<h3 id="ask-a-question">Ask a Question</h3>
<p>If you have a general how-to question or need help from the Lucene.Net
community, please email the Apache Lucene.Net-User mailing list by sending a
message to:</p>
<p><a href="mailto:[email protected]";>[email protected]</a></p>
diff --git a/contributing/mailing-lists.html b/contributing/mailing-lists.html
index a306fb5..d058218 100644
--- a/contributing/mailing-lists.html
+++ b/contributing/mailing-lists.html
@@ -73,19 +73,27 @@
<article class="content wrap" id="_content"
data-uid="contributing/mailing-lists">
<h1 id="mailing-lists">Mailing Lists</h1>
+<p>Our mailing lists help to keep you informed of the latest activities and
discussions in the Lucene.NET community.</p>
+<blockquote>
+<p>Please subscribe to a mailing list <strong>before</strong> attempting to
email to it, otherwise your query may be delayed and you may not be notified
when there is a response.</p>
+</blockquote>
<hr>
<h3 id="developers-dev">Developers
<small>([email protected])</small></h3>
-<p>The developers mailing list is used to discuss the technical future of
Lucene.Net. This mailing list also recieves comments and notifications from
GitHub</p>
-<p><em>To subscribe to this mailing lists, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.
To unsubscribe, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.</em></p>
-<p><strong><a
href="http://mail-archives.apache.org/mod_mbox/lucenenet-dev/";>Dev
Archive</a></strong></p>
+<p>The developers mailing list is used to discuss the technical future of
Lucene.Net. This mailing list also receives comments and notifications from
GitHub.</p>
+<p><em>To subscribe to this mailing list, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.
To unsubscribe, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.</em></p>
+<p><strong><a
href="https://lists.apache.org/[email protected]";>Dev
Archive</a></strong></p>
<h3 id="users-user">Users <small>([email protected])</small></h3>
-<p>A list for general how-to questions and getting help from the community.
Most (if not all) of our developers are also subscribed to this list</p>
-<p><em>To subscribe to this mailing lists, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.
To unsubscribe, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.</em></p>
-<p><strong><a
href="http://mail-archives.apache.org/mod_mbox/lucenenet-user/";>User
Archive</a></strong></p>
+<p>A list for general how-to questions and getting help from the community.
Most (if not all) of our developers are also subscribed to this list.</p>
+<p><em>To subscribe to this mailing list, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.
To unsubscribe, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.</em></p>
+<p><strong><a
href="https://lists.apache.org/[email protected]";>User
Archive</a></strong></p>
<h3 id="commits-commits">Commits
<small>([email protected])</small></h3>
-<p>To keep track of all source code submits to our repository</p>
-<p><em>To subscribe to this mailing lists, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.
To unsubscribe, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.</em></p>
-<p><strong><a
href="http://mail-archives.apache.org/mod_mbox/lucenenet-commits/";>Commit
Archive</a></strong></p>
+<p>To be notified of all source code submits to our repository.</p>
+<p><em>To subscribe to this mailing list, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.
To unsubscribe, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.</em></p>
+<p><strong><a
href="https://lists.apache.org/[email protected]";>Commit
Archive</a></strong></p>
+<h3 id="builds-builds">Builds <small>([email protected])</small></h3>
+<p>To be notified of all nightly and release builds of Lucene.NET.</p>
+<p><em>To subscribe to this mailing list, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.
To unsubscribe, send an email to <a
href="mailto:[email protected]";>[email protected]</a>.</em></p>
+<p><strong><a
href="https://lists.apache.org/[email protected]";>Builds
Archive</a></strong></p>
</article>
</div>
diff --git a/contributing/toc.html b/contributing/toc.html
index a183eed..d6e48ba 100644
--- a/contributing/toc.html
+++ b/contributing/toc.html
@@ -13,6 +13,9 @@
<ul class="nav level1">
<li>
+ <a href="community-links.html" name="" title="Community
Links">Community Links</a>
+ </li>
+ <li>
<a href="mailing-lists.html" name="" title="Mailing
Lists">Mailing Lists</a>
</li>
<li>
diff --git a/manifest.json b/manifest.json
index 9963ae6..343ed03 100644
--- a/manifest.json
+++ b/manifest.json
@@ -1,6 +1,6 @@
{
"homepages": [],
- "source_base_path": "F:/projects/lucenenet/websites/site",
+ "source_base_path":
"C:/Users/Shannon/Documents/_Projects/Lucene.Net/Lucenenet.4.x-copy/websites/site",
"xrefmap": "xrefmap.yml",
"files": [
{
@@ -49,6 +49,18 @@
},
{
"type": "Conceptual",
+ "source_relative_path": "contributing/community-links.md",
+ "output": {
+ ".html": {
+ "relative_path": "contributing/community-links.html",
+ "hash": "GC9eJBsbEoEnK0YmbQO8jg=="
+ }
+ },
+ "is_incremental": false,
+ "version": ""
+ },
+ {
+ "type": "Conceptual",
"source_relative_path": "contributing/current-status.md",
"output": {
".html": {
@@ -56,7 +68,7 @@
"hash": "HUTIwtzCe96/XKyuW7EqXg=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -68,7 +80,7 @@
"hash": "ja4FUY37CdCMWPML+Vf15A=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -77,7 +89,7 @@
"output": {
".html": {
"relative_path": "contributing/index.html",
- "hash": "L5F7bB0yVZt+WTCPNICyyA=="
+ "hash": "erin9btOIgszzNDbFQbpCQ=="
}
},
"is_incremental": false,
@@ -92,7 +104,7 @@
"hash": "kSkLX1qqvhu8jHQaExYuZQ=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -101,7 +113,7 @@
"output": {
".html": {
"relative_path": "contributing/mailing-lists.html",
- "hash": "jgL9E9M3o2lms2nzzhvz4g=="
+ "hash": "oSP25CrezJES4bTk+fwE0w=="
}
},
"is_incremental": false,
@@ -116,7 +128,7 @@
"hash": "xHt9duaHoVG4tVZhPJef9g=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -128,7 +140,7 @@
"hash": "xYYe6AEvH2OvOkGCz8y3AA=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -137,7 +149,7 @@
"output": {
".html": {
"relative_path": "contributing/toc.html",
- "hash": "mwxjvRWJyLPFUlt+kEhsKw=="
+ "hash": "Zx8/htgGbsLd2IpivlJ7mQ=="
}
},
"is_incremental": false,
@@ -152,7 +164,7 @@
"hash": "5sdTrhJ1oncpKMP+AEgIoQ=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -164,7 +176,7 @@
"hash": "TidiUfY0dJQSwC8h5JlV6g=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -176,7 +188,7 @@
"hash": "GqBHEqTZ6xk3mYquRdPMUQ=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -188,7 +200,7 @@
"hash": "lTY46ZvmykLGFrwtz3rSFA=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -212,7 +224,7 @@
"hash": "net6tG+eP5bP9+IrzHOqMQ=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -224,7 +236,7 @@
"hash": "qYtDp1836RWxHZtMHCLPVQ=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -236,7 +248,7 @@
"hash": "44NSojsEf5CqJfE1hxnPpQ=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -248,7 +260,7 @@
"hash": "RICwgzEnqSxQUUpa8o0nPA=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -260,7 +272,7 @@
"hash": "31IiAWRq9IwU016gVarXKw=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -272,7 +284,7 @@
"hash": "HiYjRVuoZ8JlQa94DRwFlA=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -284,7 +296,7 @@
"hash": "1RclUAv5rh6l7Y0sMY978w=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -296,7 +308,7 @@
"hash": "i8sqJBjvyJ1QjTkfmW/zcA=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -308,7 +320,7 @@
"hash": "Rg3h4eRw9A6q5QhtH0eYOg=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -347,8 +359,8 @@
"ConceptualDocumentProcessor": {
"can_incremental": true,
"incrementalPhase": "build",
- "total_file_count": 20,
- "skipped_file_count": 14
+ "total_file_count": 21,
+ "skipped_file_count": 19
},
"ResourceDocumentProcessor": {
"can_incremental": false,
diff --git a/xrefmap.yml b/xrefmap.yml
index dbaf509..7b5dc05 100644
--- a/xrefmap.yml
+++ b/xrefmap.yml
@@ -4,6 +4,9 @@ references:
- uid: contributing
name: Lucene.Net project contributing guide
href: contributing/index.html
+- uid: contributing/community-links
+ name: Community Links
+ href: contributing/community-links.html
- uid: contributing/current-status
name: The current status of the Lucene.Net project
href: contributing/current-status.html
