You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ignite.apache.org by ib...@apache.org on 2023/03/10 06:12:50 UTC

[ignite-3] branch main updated: IGNITE-18986 Update and enhance DEVNOTES.md (#1767)

This is an automated email from the ASF dual-hosted git repository.

ibessonov pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/ignite-3.git


The following commit(s) were added to refs/heads/main by this push:
     new dae9d8fe9a IGNITE-18986 Update and enhance DEVNOTES.md (#1767)
dae9d8fe9a is described below

commit dae9d8fe9a7dd51fb83a934b346a726432b14a17
Author: Aleksey Demakov <ad...@gmail.com>
AuthorDate: Fri Mar 10 09:12:44 2023 +0300

    IGNITE-18986 Update and enhance DEVNOTES.md (#1767)
---
 DEVNOTES.md | 36 +++++++++++++++++-------------------
 1 file changed, 17 insertions(+), 19 deletions(-)

diff --git a/DEVNOTES.md b/DEVNOTES.md
index acc54b139e..ea30da32be 100644
--- a/DEVNOTES.md
+++ b/DEVNOTES.md
@@ -14,26 +14,28 @@
 ***
 
 
-## Building Ignite
-Ignite follows standard guidelines for multi-module Gradle projects, so it can be easily built using the following command from the project root directory (you can disable the tests when building using `-x test`):
+## Quick Start
+Apache Ignite 3 follows standard guidelines for multi-module Gradle projects, so it can be built by using the following command from the
+project root directory:
 ```
 gradlew clean build
 ```
-Upon build completion, CLI tool can be found be under `modules/cli/build` directory. Use `ignite` on Linux and MacOS, or `ignite.exe` on Windows.
-***
+This command builds a project and performs a few additional actions, for example it also runs tests. The build runs faster if
+these actions are disabled as described in the next section.
 
-# Gradle build
-
-## Prerequisites
-* Java 11 SDK
+To start an ignite-3 instance, package Apache Ignite 3 as described below and then follow [the user guide](https://ignite.apache.org/docs/3.0.0-beta/quick-start/getting-started-guide).
 ***
 
 
 ## Building Ignite
-Ignite follows standard guidelines for multi-module Gradle projects, so it can be easily built using the following command from the project 
-root directory (you can disable the tests when building using `-x test`):
+Apache Ignite 3 follows standard guidelines for multi-module Gradle projects, so it can be built by using the following command from the
+project root directory (the tests are disabled with `-x test -x integrationTest` options):
 ```shell
-./gradlew clean build -x test
+./gradlew clean build -x test -x integrationTest
+```
+For a really fast build some other actions can be disabled too:
+```shell
+./gradlew clean build -x test -x integrationTest -x check -x modernizer
 ```
 ***
 
@@ -129,7 +131,8 @@ artifacts in each module (for example `modules/api/build/docs/javadoc`)
 
 
 ## Setting up IntelliJ Idea project
-You can quickly import Ignite project to your IDE using the root `build.gradle` file. In IntelliJ, choose `Open Project` from the `Quick Start` box or choose `Open...` from the `File` menu and select the root `build.gradle` file.
+You can quickly import Ignite project to your IDE using the root `build.gradle` file. In IntelliJ, choose `Open Project` from the
+`Quick Start` box or choose `Open...` from the `File` menu and select the root `build.gradle` file.
 
 After opening the project in IntelliJ, double check that the Java SDK is properly configured for the project:
 * Open the `File` menu and select `Project Structure...`
@@ -137,13 +140,8 @@ After opening the project in IntelliJ, double check that the Java SDK is properl
 * In the `Project` section, make sure the project language level is set to 11.0 as Ignite makes use of several Java 11
   language features
 
-Ignite uses machine code generation for some of it's modules. To generate necessary production code, build the project using gradle.
-
-Configure Idea code style (for IntelliJ Idea >= 2019):
-* File -> Settings -> Editor -> Code Style -> Scheme -> gear (Show Scheme Actions) -> Import Scheme -> IntelliJ IDEA code style XML
-* Choose: ${igniteProject}/idea/intellij-java-google-style.xml
-* Import schema
-* Reboot IntelliJ Idea
+Apache Ignite 3 uses machine code generation for some of its modules. Occasionally, IDEs may fail to trigger this code generation. In
+this case, run a gradle build command from the command line. Subsequent builds can be performed from IDE without problems.
 ***
 
 ## Code structure