Chapter 1: source root and packages

Author: mglukhikh

tutorial/01_Hello_World.adoc

@@ -43,3 +43,41 @@ public class Hello {
 
 Ключевое слово _public_ делает класс *открытым*, то есть доступным во всей программе. 
 `Hello` является именем класса.
+
+Язык Java придерживается ряда соглашений о структуре проекта.
+В частности, все файлы с исходным кодом должны находится в директории, которая называется *Source root*
+(переводится на русский примерно как "корневая директория исходного кода").
+В проекте с использованием систем сборки Maven или Gradle директория Source root = `ProjectDir/src/main/java`.
+В проекте без использования систем сборки всё проще: Source root = `ProjectDir/src`.
+Содержимое же директории *Source root* определяется структорой *пакетов* (_package_).
+Например:
+
+[source,java]
+----
+// test/Hello.java
+package test;
+public class Hello {
+}
+----
+
+Обратите внимание на директиву `package test` перед определением класса. 
+Это означает, что файл `Hello.java` обязан находиться в директории `test`, которая, 
+в свою очередь, должна являться поддиректорией Source root.
+О классе `Hello` в этом случае говорят, что он находится в пакете `test`,
+а *полное его имя* -- test.Hello.
+Имя файла обязано совпадать с именем определённого в нём открытого класса
+(отсюда, в частности, следует, что открытый класс в файле может быть определён лишь один).
+
+[source,java]
+----
+// another/subpack/Some.java
+package another.subpack;
+public class Some {
+}
+----
+
+Здесь класс `Some` находится в пакете `another.subpack`, 
+его полное имя -- another.subpack.Some, он обязан находиться в файле `Some.java`,
+а путь к этому файлу должен быть `another/subpack/Some.java`. 
+Директория `another` должна быть поддиректорией Source root.
+