Restructure of the introduction page (#1258) (#1274)

Cherry-picked and adapted from #1258 Co-authored-by: NataliaIvakina <[email protected]> Co-authored-by: Reneta Popova <[email protected]>
neo4j · Dec 20, 2023 · 92baf9d · 92baf9d
1 parent 2af16c5
commit 92baf9d
Showing 1 changed file with 22 additions and 74 deletions.
diff --git a/modules/ROOT/pages/introduction.adoc b/modules/ROOT/pages/introduction.adoc
@@ -36,90 +36,26 @@ Neo4j offers dedicated memory management and memory-efficient operations.
 Neo4j is scalable and can be deployed as a standalone server or across multiple machines in a fault-tolerant cluster for production environments.
 Other features for production applications include hot backups and extensive monitoring.
 
-There are two editions of Neo4j to choose from, the xref:introduction.adoc#community-edition[_Community Edition_] and the xref:introduction.adoc#enterprise-edition[_Enterprise Edition_].
-The Enterprise Edition includes all that Community Edition has to offer, plus extra enterprise requirements such as backups, clustering, and failover capabilities.
+== Neo4j editions
 
+There are two editions of self-managed Neo4j to choose from, the Community Edition (CE) and the Enterprise Edition (EE).
+The Enterprise Edition includes all that Community Edition offers, plus extra enterprise requirements such as backups, clustering, and failover capabilities.
 
-[[community-edition]]
-== Community Edition
-
+Community Edition::
 The Community Edition is a fully functional edition of Neo4j, suitable for single-instance deployments.
-It has full support for key Neo4j features, such as, ACID-compliant transactions, Cypher, and programming APIs.
+It fully supports key Neo4j features, such as ACID-compliant transactions, Cypher, and programming APIs.
 It is ideal for learning Neo4j, do-it-yourself projects, and applications in small workgroups.
 
 
-[[enterprise-edition]]
-== Enterprise Edition
-
-The Enterprise Edition extends the functionality of Community Edition to include key features for performance and scalability, such as, a clustering architecture and online backup functionality.
+Enterprise Edition::
+The Enterprise Edition extends the functionality of Community Edition to include key features for performance and scalability, such as a clustering architecture and online backup functionality.
 Additional security features include role-based access control and LDAP support, for example, Active Directory.
-It is the choice for production systems with requirements for scale and availability, such as, commercial solutions and critical internal solutions.
-
-[[versioning]]
-== Versioning
-
-Neo4j uses semantic versioning (link:{semver-uri}[Semantic Versioning Specification 2.0.0]).
-Given a version number `MAJOR.MINOR.PATCH`, the increment is based on:
-
-* `MAJOR` version - incompatible API changes towards previous `MAJOR` version.
-* `MINOR` version - functionality in a backwards compatible manner.
-* `PATCH` release - backwards compatible bug fixes.
-
-Neo4j’s fully managed cloud service link:{aura-uri}[Neo4j Aura] uses only `MAJOR` versioning.
-
-
-== Cypher
-
-Cypher is a declarative query language for graphs.
-Neo4j uses the property graph approach, where relationships are stored alongside the data in the model, and not computed at query time.
-Cypher is a powerful, graph-optimized query language that understands, and takes advantage of, these stored connections.
-When trying to find patterns or insights in data, Cypher queries are often much simpler and easier to write than massive SQL JOINs.
-Since Neo4j does not have tables, there are no JOINs to worry about.
-
-For more details, see the link:{neo4j-docs-base-uri}/cypher-manual/{page-version}[Cypher Manual -> Cypher - The Graph Query Language].
-
-
-== Interaction
-
-The recommended way of programmatically interacting with the database is either through the official Neo4j Drivers, or through using the link:{neo4j-docs-base-uri}/java-reference/{page-version}#java-reference[Java Reference -> Neo4j Java API].
-Neo4j provides an link:{wiki-acid-uri}[ACID]-compliant transactional backend for your applications.
-
-
-[[intro-drivers]]
-=== The official Neo4j Drivers
-
-The official Neo4j Drivers interacts with Neo4j via the link:{bolt-protocol-uri}[Bolt protocol ({bolt-protocol-uri})].
-
-* link:{github-neo4j-neo4j-java-driver}[Neo4j Java Driver]
-+
-For Spring-powered applications there is also link:{github-spring-projects-spring-data-neo4j}[Spring Data Neo4j].
-* link:{github-neo4j-neo4j-javascript-driver}[Neo4j JavaScript Driver]
-* link:{github-neo4j-neo4j-python-driver}[Neo4j Python Driver]
-* link:{github-neo4j-neo4j-dotnet-driver}[Neo4j .NET Driver]
-* link:{github-neo4j-neo4j-go-driver}[Neo4j Go Driver]
-
-
-[NOTE]
-====
-See the link:{download-center-drivers}[Neo4j Download Center - Drivers] for more links.
-====
-
-
-=== Other tools
-
-* xref:tools/cypher-shell.adoc[Neo4j Cypher Shell] - Command line tool for Cypher queries. link:{download-center-cyphershell}[Neo4j Download Center - Cypher Shell].
-* link:https://neo4j.com/docs/browser-manual/current/[Neo4j Browser] - Interact with Neo4j, create Cypher queries, and basic visualization capabilities.
-* link:https://neo4j.com/docs/desktop-manual/current/[Neo4j Desktop] - Developer IDE or Management Environment for Neo4j instances. link:{download-center-desktop}[Neo4j Download Center - Neo4j Desktop].
-* link:{bloom-uri}[Neo4j Bloom] - Explore and visualize graph data. link:{download-center-bloom}[Neo4j Download Center - Neo4j Bloom].
+It is the choice for production systems with requirements for scale and availability, such as commercial and critical internal solutions.
 
+The following table compares the available key features in both editions:
 
 [[edition-details]]
-== Neo4j feature details
-
-
-=== Neo4j key features
-
-.Key features
+.Community Edition vs Enterprise Edition key features
 [cols="<60,^20,^20",frame="topbot",options="header"]
 |===
 | Feature
@@ -287,3 +223,15 @@ See the link:{download-center-drivers}[Neo4j Download Center - Drivers] for more
 | {check-mark}
 
 |===
+
+[[versioning]]
+== Versioning
+
+Neo4j uses semantic versioning (link:{semver-uri}[Semantic Versioning Specification 2.0.0]).
+Given a version number `MAJOR.MINOR.PATCH`, the increment is based on:
+
+* `MAJOR` version - incompatible API changes towards previous `MAJOR` version.
+* `MINOR` version - functionality in a backwards compatible manner.
+* `PATCH` release - backwards compatible bug fixes.
+
+Neo4j’s fully managed cloud service link:{aura-uri}[Neo4j Aura] uses only `MAJOR` versioning.