diff --git a/docs/en/getting_started/example_datasets/metrica.md b/docs/en/getting_started/example_datasets/metrica.md
index 19947273338..d89fe54f4eb 100644
--- a/docs/en/getting_started/example_datasets/metrica.md
+++ b/docs/en/getting_started/example_datasets/metrica.md
@@ -1,51 +1,62 @@
 # Anonymized Yandex.Metrica Data
-Dataset consists of two tables containing anonymized data about hits (`hits_v1`) and visits (`visits_v1`) of Yandex.Metrica. Each of the tables can be downloaded as a compressed `tsv.xz` file or as prepared partitions. In addition to that, an extended version of the `hits` table containing 100 million rows is available as [TSV](https://clickhouse-datasets.s3.yandex.net/hits/tsv/hits_100m_obfuscated_v1.tsv.xz) and as [prepared partitions](https://clickhouse-datasets.s3.yandex.net/hits/partitions/hits_100m_obfuscated_v1.tar.xz).
+Dataset consists of two tables containing anonymized data about hits (`hits_v1`) and visits (`visits_v1`) of Yandex.Metrica. You can read more about Yandex.Metrica in [ClickHouse history](../../introduction/history.md) section.
+
+The dataset consists of two tables, either of them can be downloaded as a compressed `tsv.xz` file or as prepared partitions. In addition to that, an extended version of the `hits` table containing 100 million rows is available as TSV at <https://clickhouse-datasets.s3.yandex.net/hits/tsv/hits_100m_obfuscated_v1.tsv.xz> and as prepared partitions at <https://clickhouse-datasets.s3.yandex.net/hits/partitions/hits_100m_obfuscated_v1.tar.xz>.
 
 ## Obtaining Tables from Prepared Partitions
-**Download and import hits:**
-```bash
-$ curl -O https://clickhouse-datasets.s3.yandex.net/hits/partitions/hits_v1.tar
-$ tar xvf hits_v1.tar -C /var/lib/clickhouse # path to ClickHouse data directory
-$ # check permissions on unpacked data, fix if required
-$ sudo service clickhouse-server restart
-$ clickhouse-client --query "SELECT COUNT(*) FROM datasets.hits_v1"
+
+Download and import hits table:
+
+``` bash
+curl -O https://clickhouse-datasets.s3.yandex.net/hits/partitions/hits_v1.tar
+tar xvf hits_v1.tar -C /var/lib/clickhouse # path to ClickHouse data directory
+# check permissions on unpacked data, fix if required
+sudo service clickhouse-server restart
+clickhouse-client --query "SELECT COUNT(*) FROM datasets.hits_v1"
 ```
 
-**Download and import visits:**
-```bash
-$ curl -O https://clickhouse-datasets.s3.yandex.net/visits/partitions/visits_v1.tar
-$ tar xvf visits_v1.tar -C /var/lib/clickhouse # path to ClickHouse data directory
-$ # check permissions on unpacked data, fix if required
-$ sudo service clickhouse-server restart
-$ clickhouse-client --query "SELECT COUNT(*) FROM datasets.visits_v1"
+Download and import visits:
+
+``` bash
+curl -O https://clickhouse-datasets.s3.yandex.net/visits/partitions/visits_v1.tar
+tar xvf visits_v1.tar -C /var/lib/clickhouse # path to ClickHouse data directory
+# check permissions on unpacked data, fix if required
+sudo service clickhouse-server restart
+clickhouse-client --query "SELECT COUNT(*) FROM datasets.visits_v1"
 ```
 
-## Obtaining Tables from Compressed tsv-file
-**Download and import hits from compressed tsv-file**
-```bash
-$ curl https://clickhouse-datasets.s3.yandex.net/hits/tsv/hits_v1.tsv.xz | unxz --threads=`nproc` > hits_v1.tsv 
-$ # now create table
-$ clickhouse-client --query "CREATE DATABASE IF NOT EXISTS datasets"
-$ clickhouse-client --query "CREATE TABLE datasets.hits_v1 ( WatchID UInt64,  JavaEnable UInt8,  Title String,  GoodEvent Int16,  EventTime DateTime,  EventDate Date,  CounterID UInt32,  ClientIP UInt32,  ClientIP6 FixedString(16),  RegionID UInt32,  UserID UInt64,  CounterClass Int8,  OS UInt8,  UserAgent UInt8,  URL String,  Referer String,  URLDomain String,  RefererDomain String,  Refresh UInt8,  IsRobot UInt8,  RefererCategories Array(UInt16),  URLCategories Array(UInt16), URLRegions Array(UInt32),  RefererRegions Array(UInt32),  ResolutionWidth UInt16,  ResolutionHeight UInt16,  ResolutionDepth UInt8,  FlashMajor UInt8, FlashMinor UInt8,  FlashMinor2 String,  NetMajor UInt8,  NetMinor UInt8, UserAgentMajor UInt16,  UserAgentMinor FixedString(2),  CookieEnable UInt8, JavascriptEnable UInt8,  IsMobile UInt8,  MobilePhone UInt8,  MobilePhoneModel String,  Params String,  IPNetworkID UInt32,  TraficSourceID Int8, SearchEngineID UInt16,  SearchPhrase String,  AdvEngineID UInt8,  IsArtifical UInt8,  WindowClientWidth UInt16,  WindowClientHeight UInt16,  ClientTimeZone Int16,  ClientEventTime DateTime,  SilverlightVersion1 UInt8, SilverlightVersion2 UInt8,  SilverlightVersion3 UInt32,  SilverlightVersion4 UInt16,  PageCharset String,  CodeVersion UInt32,  IsLink UInt8,  IsDownload UInt8,  IsNotBounce UInt8,  FUniqID UInt64,  HID UInt32,  IsOldCounter UInt8, IsEvent UInt8,  IsParameter UInt8,  DontCountHits UInt8,  WithHash UInt8, HitColor FixedString(1),  UTCEventTime DateTime,  Age UInt8,  Sex UInt8,  Income UInt8,  Interests UInt16,  Robotness UInt8,  GeneralInterests Array(UInt16), RemoteIP UInt32,  RemoteIP6 FixedString(16),  WindowName Int32,  OpenerName Int32,  HistoryLength Int16,  BrowserLanguage FixedString(2),  BrowserCountry FixedString(2),  SocialNetwork String,  SocialAction String,  HTTPError UInt16, SendTiming Int32,  DNSTiming Int32,  ConnectTiming Int32,  ResponseStartTiming Int32,  ResponseEndTiming Int32,  FetchTiming Int32,  RedirectTiming Int32, DOMInteractiveTiming Int32,  DOMContentLoadedTiming Int32,  DOMCompleteTiming Int32,  LoadEventStartTiming Int32,  LoadEventEndTiming Int32, NSToDOMContentLoadedTiming Int32,  FirstPaintTiming Int32,  RedirectCount Int8, SocialSourceNetworkID UInt8,  SocialSourcePage String,  ParamPrice Int64, ParamOrderID String,  ParamCurrency FixedString(3),  ParamCurrencyID UInt16, GoalsReached Array(UInt32),  OpenstatServiceName String,  OpenstatCampaignID String,  OpenstatAdID String,  OpenstatSourceID String,  UTMSource String, UTMMedium String,  UTMCampaign String,  UTMContent String,  UTMTerm String, FromTag String,  HasGCLID UInt8,  RefererHash UInt64,  URLHash UInt64,  CLID UInt32,  YCLID UInt64,  ShareService String,  ShareURL String,  ShareTitle String,  ParsedParams Nested(Key1 String,  Key2 String, Key3 String, Key4 String, Key5 String,  ValueDouble Float64),  IslandID FixedString(16),  RequestNum UInt32,  RequestTry UInt8) ENGINE = MergeTree() PARTITION BY toYYYYMM(EventDate) ORDER BY (CounterID, EventDate, intHash32(UserID)) SAMPLE BY intHash32(UserID) SETTINGS index_granularity = 8192"
-$ # import data
-$ cat hits_v1.tsv | clickhouse-client --query "INSERT INTO datasets.hits_v1 FORMAT TSV" --max_insert_block_size=100000
-$ # optionally you can optimize table
-$ clickhouse-client --query "OPTIMIZE TABLE datasets.hits_v1 FINAL"
-$ clickhouse-client --query "SELECT COUNT(*) FROM datasets.hits_v1"
+## Obtaining Tables from Compressed TSV File
+
+Download and import hits from compressed TSV file:
+
+``` bash
+curl https://clickhouse-datasets.s3.yandex.net/hits/tsv/hits_v1.tsv.xz | unxz --threads=`nproc` > hits_v1.tsv 
+# now create table
+clickhouse-client --query "CREATE DATABASE IF NOT EXISTS datasets"
+clickhouse-client --query "CREATE TABLE datasets.hits_v1 ( WatchID UInt64,  JavaEnable UInt8,  Title String,  GoodEvent Int16,  EventTime DateTime,  EventDate Date,  CounterID UInt32,  ClientIP UInt32,  ClientIP6 FixedString(16),  RegionID UInt32,  UserID UInt64,  CounterClass Int8,  OS UInt8,  UserAgent UInt8,  URL String,  Referer String,  URLDomain String,  RefererDomain String,  Refresh UInt8,  IsRobot UInt8,  RefererCategories Array(UInt16),  URLCategories Array(UInt16), URLRegions Array(UInt32),  RefererRegions Array(UInt32),  ResolutionWidth UInt16,  ResolutionHeight UInt16,  ResolutionDepth UInt8,  FlashMajor UInt8, FlashMinor UInt8,  FlashMinor2 String,  NetMajor UInt8,  NetMinor UInt8, UserAgentMajor UInt16,  UserAgentMinor FixedString(2),  CookieEnable UInt8, JavascriptEnable UInt8,  IsMobile UInt8,  MobilePhone UInt8,  MobilePhoneModel String,  Params String,  IPNetworkID UInt32,  TraficSourceID Int8, SearchEngineID UInt16,  SearchPhrase String,  AdvEngineID UInt8,  IsArtifical UInt8,  WindowClientWidth UInt16,  WindowClientHeight UInt16,  ClientTimeZone Int16,  ClientEventTime DateTime,  SilverlightVersion1 UInt8, SilverlightVersion2 UInt8,  SilverlightVersion3 UInt32,  SilverlightVersion4 UInt16,  PageCharset String,  CodeVersion UInt32,  IsLink UInt8,  IsDownload UInt8,  IsNotBounce UInt8,  FUniqID UInt64,  HID UInt32,  IsOldCounter UInt8, IsEvent UInt8,  IsParameter UInt8,  DontCountHits UInt8,  WithHash UInt8, HitColor FixedString(1),  UTCEventTime DateTime,  Age UInt8,  Sex UInt8,  Income UInt8,  Interests UInt16,  Robotness UInt8,  GeneralInterests Array(UInt16), RemoteIP UInt32,  RemoteIP6 FixedString(16),  WindowName Int32,  OpenerName Int32,  HistoryLength Int16,  BrowserLanguage FixedString(2),  BrowserCountry FixedString(2),  SocialNetwork String,  SocialAction String,  HTTPError UInt16, SendTiming Int32,  DNSTiming Int32,  ConnectTiming Int32,  ResponseStartTiming Int32,  ResponseEndTiming Int32,  FetchTiming Int32,  RedirectTiming Int32, DOMInteractiveTiming Int32,  DOMContentLoadedTiming Int32,  DOMCompleteTiming Int32,  LoadEventStartTiming Int32,  LoadEventEndTiming Int32, NSToDOMContentLoadedTiming Int32,  FirstPaintTiming Int32,  RedirectCount Int8, SocialSourceNetworkID UInt8,  SocialSourcePage String,  ParamPrice Int64, ParamOrderID String,  ParamCurrency FixedString(3),  ParamCurrencyID UInt16, GoalsReached Array(UInt32),  OpenstatServiceName String,  OpenstatCampaignID String,  OpenstatAdID String,  OpenstatSourceID String,  UTMSource String, UTMMedium String,  UTMCampaign String,  UTMContent String,  UTMTerm String, FromTag String,  HasGCLID UInt8,  RefererHash UInt64,  URLHash UInt64,  CLID UInt32,  YCLID UInt64,  ShareService String,  ShareURL String,  ShareTitle String,  ParsedParams Nested(Key1 String,  Key2 String, Key3 String, Key4 String, Key5 String,  ValueDouble Float64),  IslandID FixedString(16),  RequestNum UInt32,  RequestTry UInt8) ENGINE = MergeTree() PARTITION BY toYYYYMM(EventDate) ORDER BY (CounterID, EventDate, intHash32(UserID)) SAMPLE BY intHash32(UserID) SETTINGS index_granularity = 8192"
+# import data
+cat hits_v1.tsv | clickhouse-client --query "INSERT INTO datasets.hits_v1 FORMAT TSV" --max_insert_block_size=100000
+# optionally you can optimize table
+clickhouse-client --query "OPTIMIZE TABLE datasets.hits_v1 FINAL"
+clickhouse-client --query "SELECT COUNT(*) FROM datasets.hits_v1"
 ```
 
-**Download and import visits from compressed tsv-file**
-```bash
-$ curl https://clickhouse-datasets.s3.yandex.net/visits/tsv/visits_v1.tsv.xz | unxz --threads=`nproc` > visits_v1.tsv 
-$ # now create table
-$ clickhouse-client --query "CREATE DATABASE IF NOT EXISTS datasets"
-$ clickhouse-client --query "CREATE TABLE datasets.visits_v1 ( CounterID UInt32,  StartDate Date,  Sign Int8,  IsNew UInt8,  VisitID UInt64,  UserID UInt64,  StartTime DateTime,  Duration UInt32,  UTCStartTime DateTime,  PageViews Int32,  Hits Int32,  IsBounce UInt8,  Referer String,  StartURL String,  RefererDomain String,  StartURLDomain String,  EndURL String,  LinkURL String,  IsDownload UInt8,  TraficSourceID Int8,  SearchEngineID UInt16,  SearchPhrase String,  AdvEngineID UInt8,  PlaceID Int32,  RefererCategories Array(UInt16),  URLCategories Array(UInt16),  URLRegions Array(UInt32),  RefererRegions Array(UInt32),  IsYandex UInt8,  GoalReachesDepth Int32,  GoalReachesURL Int32,  GoalReachesAny Int32,  SocialSourceNetworkID UInt8,  SocialSourcePage String,  MobilePhoneModel String,  ClientEventTime DateTime,  RegionID UInt32,  ClientIP UInt32,  ClientIP6 FixedString(16),  RemoteIP UInt32,  RemoteIP6 FixedString(16),  IPNetworkID UInt32,  SilverlightVersion3 UInt32,  CodeVersion UInt32,  ResolutionWidth UInt16,  ResolutionHeight UInt16,  UserAgentMajor UInt16,  UserAgentMinor UInt16,  WindowClientWidth UInt16,  WindowClientHeight UInt16,  SilverlightVersion2 UInt8,  SilverlightVersion4 UInt16,  FlashVersion3 UInt16,  FlashVersion4 UInt16,  ClientTimeZone Int16,  OS UInt8,  UserAgent UInt8,  ResolutionDepth UInt8,  FlashMajor UInt8,  FlashMinor UInt8,  NetMajor UInt8,  NetMinor UInt8,  MobilePhone UInt8,  SilverlightVersion1 UInt8,  Age UInt8,  Sex UInt8,  Income UInt8,  JavaEnable UInt8,  CookieEnable UInt8,  JavascriptEnable UInt8,  IsMobile UInt8,  BrowserLanguage UInt16,  BrowserCountry UInt16,  Interests UInt16,  Robotness UInt8,  GeneralInterests Array(UInt16),  Params Array(String),  Goals Nested(ID UInt32, Serial UInt32, EventTime DateTime,  Price Int64,  OrderID String, CurrencyID UInt32),  WatchIDs Array(UInt64),  ParamSumPrice Int64,  ParamCurrency FixedString(3),  ParamCurrencyID UInt16,  ClickLogID UInt64,  ClickEventID Int32,  ClickGoodEvent Int32,  ClickEventTime DateTime,  ClickPriorityID Int32,  ClickPhraseID Int32,  ClickPageID Int32,  ClickPlaceID Int32,  ClickTypeID Int32,  ClickResourceID Int32,  ClickCost UInt32,  ClickClientIP UInt32,  ClickDomainID UInt32,  ClickURL String,  ClickAttempt UInt8,  ClickOrderID UInt32,  ClickBannerID UInt32,  ClickMarketCategoryID UInt32,  ClickMarketPP UInt32,  ClickMarketCategoryName String,  ClickMarketPPName String,  ClickAWAPSCampaignName String,  ClickPageName String,  ClickTargetType UInt16,  ClickTargetPhraseID UInt64,  ClickContextType UInt8,  ClickSelectType Int8,  ClickOptions String,  ClickGroupBannerID Int32,  OpenstatServiceName String,  OpenstatCampaignID String,  OpenstatAdID String,  OpenstatSourceID String,  UTMSource String,  UTMMedium String,  UTMCampaign String,  UTMContent String,  UTMTerm String,  FromTag String,  HasGCLID UInt8,  FirstVisit DateTime,  PredLastVisit Date,  LastVisit Date,  TotalVisits UInt32,  TraficSource    Nested(ID Int8,  SearchEngineID UInt16, AdvEngineID UInt8, PlaceID UInt16, SocialSourceNetworkID UInt8, Domain String, SearchPhrase String, SocialSourcePage String),  Attendance FixedString(16),  CLID UInt32,  YCLID UInt64,  NormalizedRefererHash UInt64,  SearchPhraseHash UInt64,  RefererDomainHash UInt64,  NormalizedStartURLHash UInt64,  StartURLDomainHash UInt64,  NormalizedEndURLHash UInt64,  TopLevelDomain UInt64,  URLScheme UInt64,  OpenstatServiceNameHash UInt64,  OpenstatCampaignIDHash UInt64,  OpenstatAdIDHash UInt64,  OpenstatSourceIDHash UInt64,  UTMSourceHash UInt64,  UTMMediumHash UInt64,  UTMCampaignHash UInt64,  UTMContentHash UInt64,  UTMTermHash UInt64,  FromHash UInt64,  WebVisorEnabled UInt8,  WebVisorActivity UInt32,  ParsedParams    Nested(Key1 String,  Key2 String,  Key3 String,  Key4 String, Key5 String, ValueDouble    Float64),  Market Nested(Type UInt8, GoalID UInt32, OrderID String,  OrderPrice Int64,  PP UInt32,  DirectPlaceID UInt32,  DirectOrderID  UInt32,  DirectBannerID UInt32,  GoodID String, GoodName String, GoodQuantity Int32,  GoodPrice Int64),  IslandID FixedString(16)) ENGINE = CollapsingMergeTree(StartDate, intHash32(UserID), (CounterID, StartDate, intHash32(UserID), VisitID), 8192, Sign)"
-$ # import data
-$ cat visits_v1.tsv | clickhouse-client --query "INSERT INTO datasets.visits_v1 FORMAT TSV" --max_insert_block_size=100000
-$ # optionally you can optimize table
-$ clickhouse-client --query "OPTIMIZE TABLE datasets.visits_v1 FINAL"
-$ clickhouse-client --query "SELECT COUNT(*) FROM datasets.visits_v1"
+Download and import visits from compressed tsv-file:
+
+``` bash
+curl https://clickhouse-datasets.s3.yandex.net/visits/tsv/visits_v1.tsv.xz | unxz --threads=`nproc` > visits_v1.tsv 
+# now create table
+clickhouse-client --query "CREATE DATABASE IF NOT EXISTS datasets"
+clickhouse-client --query "CREATE TABLE datasets.visits_v1 ( CounterID UInt32,  StartDate Date,  Sign Int8,  IsNew UInt8,  VisitID UInt64,  UserID UInt64,  StartTime DateTime,  Duration UInt32,  UTCStartTime DateTime,  PageViews Int32,  Hits Int32,  IsBounce UInt8,  Referer String,  StartURL String,  RefererDomain String,  StartURLDomain String,  EndURL String,  LinkURL String,  IsDownload UInt8,  TraficSourceID Int8,  SearchEngineID UInt16,  SearchPhrase String,  AdvEngineID UInt8,  PlaceID Int32,  RefererCategories Array(UInt16),  URLCategories Array(UInt16),  URLRegions Array(UInt32),  RefererRegions Array(UInt32),  IsYandex UInt8,  GoalReachesDepth Int32,  GoalReachesURL Int32,  GoalReachesAny Int32,  SocialSourceNetworkID UInt8,  SocialSourcePage String,  MobilePhoneModel String,  ClientEventTime DateTime,  RegionID UInt32,  ClientIP UInt32,  ClientIP6 FixedString(16),  RemoteIP UInt32,  RemoteIP6 FixedString(16),  IPNetworkID UInt32,  SilverlightVersion3 UInt32,  CodeVersion UInt32,  ResolutionWidth UInt16,  ResolutionHeight UInt16,  UserAgentMajor UInt16,  UserAgentMinor UInt16,  WindowClientWidth UInt16,  WindowClientHeight UInt16,  SilverlightVersion2 UInt8,  SilverlightVersion4 UInt16,  FlashVersion3 UInt16,  FlashVersion4 UInt16,  ClientTimeZone Int16,  OS UInt8,  UserAgent UInt8,  ResolutionDepth UInt8,  FlashMajor UInt8,  FlashMinor UInt8,  NetMajor UInt8,  NetMinor UInt8,  MobilePhone UInt8,  SilverlightVersion1 UInt8,  Age UInt8,  Sex UInt8,  Income UInt8,  JavaEnable UInt8,  CookieEnable UInt8,  JavascriptEnable UInt8,  IsMobile UInt8,  BrowserLanguage UInt16,  BrowserCountry UInt16,  Interests UInt16,  Robotness UInt8,  GeneralInterests Array(UInt16),  Params Array(String),  Goals Nested(ID UInt32, Serial UInt32, EventTime DateTime,  Price Int64,  OrderID String, CurrencyID UInt32),  WatchIDs Array(UInt64),  ParamSumPrice Int64,  ParamCurrency FixedString(3),  ParamCurrencyID UInt16,  ClickLogID UInt64,  ClickEventID Int32,  ClickGoodEvent Int32,  ClickEventTime DateTime,  ClickPriorityID Int32,  ClickPhraseID Int32,  ClickPageID Int32,  ClickPlaceID Int32,  ClickTypeID Int32,  ClickResourceID Int32,  ClickCost UInt32,  ClickClientIP UInt32,  ClickDomainID UInt32,  ClickURL String,  ClickAttempt UInt8,  ClickOrderID UInt32,  ClickBannerID UInt32,  ClickMarketCategoryID UInt32,  ClickMarketPP UInt32,  ClickMarketCategoryName String,  ClickMarketPPName String,  ClickAWAPSCampaignName String,  ClickPageName String,  ClickTargetType UInt16,  ClickTargetPhraseID UInt64,  ClickContextType UInt8,  ClickSelectType Int8,  ClickOptions String,  ClickGroupBannerID Int32,  OpenstatServiceName String,  OpenstatCampaignID String,  OpenstatAdID String,  OpenstatSourceID String,  UTMSource String,  UTMMedium String,  UTMCampaign String,  UTMContent String,  UTMTerm String,  FromTag String,  HasGCLID UInt8,  FirstVisit DateTime,  PredLastVisit Date,  LastVisit Date,  TotalVisits UInt32,  TraficSource    Nested(ID Int8,  SearchEngineID UInt16, AdvEngineID UInt8, PlaceID UInt16, SocialSourceNetworkID UInt8, Domain String, SearchPhrase String, SocialSourcePage String),  Attendance FixedString(16),  CLID UInt32,  YCLID UInt64,  NormalizedRefererHash UInt64,  SearchPhraseHash UInt64,  RefererDomainHash UInt64,  NormalizedStartURLHash UInt64,  StartURLDomainHash UInt64,  NormalizedEndURLHash UInt64,  TopLevelDomain UInt64,  URLScheme UInt64,  OpenstatServiceNameHash UInt64,  OpenstatCampaignIDHash UInt64,  OpenstatAdIDHash UInt64,  OpenstatSourceIDHash UInt64,  UTMSourceHash UInt64,  UTMMediumHash UInt64,  UTMCampaignHash UInt64,  UTMContentHash UInt64,  UTMTermHash UInt64,  FromHash UInt64,  WebVisorEnabled UInt8,  WebVisorActivity UInt32,  ParsedParams    Nested(Key1 String,  Key2 String,  Key3 String,  Key4 String, Key5 String, ValueDouble    Float64),  Market Nested(Type UInt8, GoalID UInt32, OrderID String,  OrderPrice Int64,  PP UInt32,  DirectPlaceID UInt32,  DirectOrderID  UInt32,  DirectBannerID UInt32,  GoodID String, GoodName String, GoodQuantity Int32,  GoodPrice Int64),  IslandID FixedString(16)) ENGINE = CollapsingMergeTree(StartDate, intHash32(UserID), (CounterID, StartDate, intHash32(UserID), VisitID), 8192, Sign)"
+# import data
+cat visits_v1.tsv | clickhouse-client --query "INSERT INTO datasets.visits_v1 FORMAT TSV" --max_insert_block_size=100000
+# optionally you can optimize table
+clickhouse-client --query "OPTIMIZE TABLE datasets.visits_v1 FINAL"
+clickhouse-client --query "SELECT COUNT(*) FROM datasets.visits_v1"
 ```
 
-## Queries
-Examples of queries to these tables (they are named `test.hits` and `test.visits`) can be found among [stateful tests](https://github.com/ClickHouse/ClickHouse/tree/master/dbms/tests/queries/1_stateful) and in some [performance tests](https://github.com/ClickHouse/ClickHouse/tree/master/dbms/tests/performance) of ClickHouse.
+## Example Queries
+
+[ClickHouse tutorial](../../getting_started/tutorial.md) is based on Yandex.Metrica dataset and the recommended way to get started with this dataset is to just go through tutorial.
+
+Additional examples of queries to these tables can be found among [stateful tests](https://github.com/yandex/ClickHouse/tree/master/dbms/tests/queries/1_stateful) of ClickHouse (they are named `test.hists` and `test.visits` there).
diff --git a/docs/en/getting_started/index.md b/docs/en/getting_started/index.md
index ed7335b748b..bfdcb0e108a 100644
--- a/docs/en/getting_started/index.md
+++ b/docs/en/getting_started/index.md
@@ -1,147 +1,8 @@
 # Getting Started
 
-## System Requirements
-
-ClickHouse can run on any Linux, FreeBSD or Mac OS X with x86\_64 CPU architecture.
-
-Though pre-built binaries are typically compiled to leverage SSE 4.2 instruction set, so unless otherwise stated usage of CPU that supports it becomes an additional system requirement. Here's the command to check if current CPU has support for SSE 4.2:
-
-``` bash
-$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
-```
-
-## Installation
-
-### From DEB Packages
-
-Yandex ClickHouse team recommends using official pre-compiled `deb` packages for Debian or Ubuntu.
-
-To install official packages add the Yandex repository in `/etc/apt/sources.list` or in a separate `/etc/apt/sources.list.d/clickhouse.list` file:
-
-```bash
-$ deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
-```
-
-If you want to use the most recent version, replace `stable` with `testing` (this is recommended for your testing environments).
-
-Then run these commands to actually install packages:
-
-```bash
-$ sudo apt-get install dirmngr    # optional
-$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
-$ sudo apt-get update
-$ sudo apt-get install clickhouse-client clickhouse-server
-```
-
-You can also download and install packages manually from here: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
-
-### From RPM Packages
-
-Yandex ClickHouse team recommends using official pre-compiled `rpm` packages for CentOS, RedHat and all other rpm-based Linux distributions.
-
-First you need to add the official repository:
-
-```bash
-$ sudo yum install yum-utils
-$ sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
-$ sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
-```
-
-If you want to use the most recent version, replace `stable` with `testing` (this is recommended for your testing environments).
-
-Then run these commands to actually install packages:
-
-```bash
-$ sudo yum install clickhouse-server clickhouse-client
-```
-
-You can also download and install packages manually from here: <https://repo.yandex.ru/clickhouse/rpm/stable/x86_64>.
-
-### From Docker Image
-
-To run ClickHouse inside Docker follow the guide on [Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/). Those images use official `deb` packages inside.
-
-### From Sources
-
-To manually compile ClickHouse, follow the instructions for [Linux](../development/build.md) or [Mac OS X](../development/build_osx.md).
-
-You can compile packages and install them or use programs without installing packages. Also by building manually you can disable SSE 4.2 requirement or build for AArch64 CPUs.
-
-```text
-Client: dbms/programs/clickhouse-client
-Server: dbms/programs/clickhouse-server
-```
-
-You'll need to create a data and metadata folders and `chown` them for the desired user. Their paths can be changed in server config (src/dbms/programs/server/config.xml), by default they are:
-```text
-/opt/clickhouse/data/default/
-/opt/clickhouse/metadata/default/
-```
-
-On Gentoo you can just use `emerge clickhouse` to install ClickHouse from sources.
-
-## Launch
-
-To start the server as a daemon, run:
-
-``` bash
-$ sudo service clickhouse-server start
-```
-
-If you don't have `service` command, run as
-
-``` bash
-$ sudo /etc/init.d/clickhouse-server start
-```
-
-
-See the logs in the `/var/log/clickhouse-server/` directory.
-
-If the server doesn't start, check the configurations in the file `/etc/clickhouse-server/config.xml`.
-
-You can also manually launch the server from the console:
-
-``` bash
-$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml
-```
-
-In this case, the log will be printed to the console, which is convenient during development.
-If the configuration file is in the current directory, you don't need to specify the `--config-file` parameter. By default, it uses `./config.xml`.
-
-ClickHouse supports access restriction settings. They are located in the `users.xml` file (next to `config.xml`).
-By default, access is allowed from anywhere for the `default` user, without a password. See `user/default/networks`.
-For more information, see the section ["Configuration Files"](../operations/configuration_files.md).
-
-After launching server, you can use the command-line client to connect to it:
-
-``` bash
-$ clickhouse-client
-```
-
-By default it connects to `localhost:9000` on behalf of the user `default` without a password. It can also be used to connect to a remote server using `--host` argument.
-
-The terminal must use UTF-8 encoding.
-For more information, see the section ["Command-line client"](../interfaces/cli.md).
-
-Example:
-``` bash
-$ ./clickhouse-client
-ClickHouse client version 0.0.18749.
-Connecting to localhost:9000.
-Connected to ClickHouse server version 0.0.18749.
-```
-```sql
-SELECT 1
-```
-```text
-┌─1─┐
-│ 1 │
-└───┘
-```
-
-**Congratulations, the system works!**
-
-To continue experimenting, you can download one of test data sets or go through [tutorial](https://clickhouse.yandex/tutorial.html).
+If you are new to ClickHouse and want to get a hands-on feeling of it's performance, first of all you need to go through the [installation process](install.md). After that you can:
 
+* [Go through detailed tutorial](tutorial.md)
+* [Experiment with example datasets](example_datasets/ontime.md)
 
 [Original article](https://clickhouse.yandex/docs/en/getting_started/) <!--hide-->
diff --git a/docs/en/getting_started/install.md b/docs/en/getting_started/install.md
new file mode 100644
index 00000000000..e47500fa22f
--- /dev/null
+++ b/docs/en/getting_started/install.md
@@ -0,0 +1,153 @@
+# Installation
+
+## System Requirements
+
+ClickHouse can run on any Linux, FreeBSD or Mac OS X with x86\_64, AArch64 or PowerPC64LE CPU architecture.
+
+Official pre-built binaries are typically compiled for x86\_64 and leverage SSE 4.2 instruction set, so unless otherwise stated usage of CPU that supports it becomes an additional system requirement. Here's the command to check if current CPU has support for SSE 4.2:
+
+``` bash
+$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
+```
+
+To run ClickHouse on processors that do not support SSE 4.2 or have AArch64 or PowerPC64LE architecture, you should [build ClickHouse from sources](#from-sources) with proper configuration adjustments.
+
+## Available Installation Options
+
+### From DEB Packages
+
+It is recommended to use official pre-compiled `deb` packages for Debian or Ubuntu.
+
+To install official packages add the Yandex repository in `/etc/apt/sources.list` or in a separate `/etc/apt/sources.list.d/clickhouse.list` file:
+
+```
+deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
+```
+
+If you want to use the most recent version, replace `stable` with `testing` (this is recommended for your testing environments).
+
+Then run these commands to actually install packages:
+
+```bash
+sudo apt-get install dirmngr    # optional
+sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
+sudo apt-get update
+sudo apt-get install clickhouse-client clickhouse-server
+```
+
+You can also download and install packages manually from here: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
+
+### From RPM Packages
+
+It is recommended to use official pre-compiled `rpm` packages for CentOS, RedHat and all other rpm-based Linux distributions.
+
+First you need to add the official repository:
+
+```bash
+sudo yum install yum-utils
+sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
+sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
+```
+
+If you want to use the most recent version, replace `stable` with `testing` (this is recommended for your testing environments).
+
+Then run these commands to actually install packages:
+
+```bash
+sudo yum install clickhouse-server clickhouse-client
+```
+
+You can also download and install packages manually from here: <https://repo.yandex.ru/clickhouse/rpm/stable/x86_64>.
+
+### From Docker Image
+
+To run ClickHouse inside Docker follow the guide on [Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/). Those images use official `deb` packages inside.
+
+### From Sources
+
+To manually compile ClickHouse, follow the instructions for [Linux](../development/build.md) or [Mac OS X](../development/build_osx.md).
+
+You can compile packages and install them or use programs without installing packages. Also by building manually you can disable SSE 4.2 requirement or build for AArch64 CPUs.
+
+```
+Client: dbms/programs/clickhouse-client
+Server: dbms/programs/clickhouse-server
+```
+
+You'll need to create a data and metadata folders and `chown` them for the desired user. Their paths can be changed in server config (src/dbms/programs/server/config.xml), by default they are:
+```
+/opt/clickhouse/data/default/
+/opt/clickhouse/metadata/default/
+```
+
+On Gentoo you can just use `emerge clickhouse` to install ClickHouse from sources.
+
+## Launch
+
+To start the server as a daemon, run:
+
+``` bash
+$ sudo service clickhouse-server start
+```
+
+If you don't have `service` command, run as
+
+``` bash
+$ sudo /etc/init.d/clickhouse-server start
+```
+
+
+See the logs in the `/var/log/clickhouse-server/` directory.
+
+If the server doesn't start, check the configurations in the file `/etc/clickhouse-server/config.xml`.
+
+You can also manually launch the server from the console:
+
+``` bash
+$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml
+```
+
+In this case, the log will be printed to the console, which is convenient during development.
+If the configuration file is in the current directory, you don't need to specify the `--config-file` parameter. By default, it uses `./config.xml`.
+
+ClickHouse supports access restriction settings. They are located in the `users.xml` file (next to `config.xml`).
+By default, access is allowed from anywhere for the `default` user, without a password. See `user/default/networks`.
+For more information, see the section ["Configuration Files"](../operations/configuration_files.md).
+
+After launching server, you can use the command-line client to connect to it:
+
+``` bash
+$ clickhouse-client
+```
+
+By default it connects to `localhost:9000` on behalf of the user `default` without a password. It can also be used to connect to a remote server using `--host` argument.
+
+The terminal must use UTF-8 encoding.
+For more information, see the section ["Command-line client"](../interfaces/cli.md).
+
+Example:
+``` bash
+$ ./clickhouse-client
+ClickHouse client version 0.0.18749.
+Connecting to localhost:9000.
+Connected to ClickHouse server version 0.0.18749.
+
+:) SELECT 1
+
+SELECT 1
+
+┌─1─┐
+│ 1 │
+└───┘
+
+1 rows in set. Elapsed: 0.003 sec.
+
+:)
+```
+
+**Congratulations, the system works!**
+
+To continue experimenting, you can download one of test data sets or go through [tutorial](https://clickhouse.yandex/tutorial.html).
+
+
+[Original article](https://clickhouse.yandex/docs/en/getting_started/install/) <!--hide-->
diff --git a/docs/en/getting_started/tutorial.md b/docs/en/getting_started/tutorial.md
new file mode 100644
index 00000000000..acdd9074beb
--- /dev/null
+++ b/docs/en/getting_started/tutorial.md
@@ -0,0 +1,645 @@
+# ClickHouse Tutorial
+
+## What to Expect from This Tutorial?
+
+By going through this tutorial you'll learn how to set up basic ClickHouse cluster, it'll be small, but fault tolerant and scalable. We will use one of example datasets to fill it with data and execute some demo queries.
+
+## Single Node Setup
+
+To postpone complexities of distributed environment, we'll start with deploying ClickHouse on a single server or virtual machine. ClickHouse is usually installed from [deb](index.md#from-deb-packages) or [rpm](index.md#from-rpm-packages) packages, but there are [alternatives](index.md#from-docker-image) for the operating systems that do no support them.
+
+For example, you have chosen `deb` packages and executed:
+``` bash
+sudo apt-get install dirmngr
+sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4
+
+echo "deb http://repo.yandex.ru/clickhouse/deb/stable/ main/" | sudo tee /etc/apt/sources.list.d/clickhouse.list
+sudo apt-get update
+
+sudo apt-get install -y clickhouse-server clickhouse-client
+```
+
+What do we have in the packages that got installed:
+
+* `clickhouse-client` package contains [clickhouse-client](../interfaces/cli.md) application, interactive ClickHouse console client.
+* `clickhouse-common` package contains a ClickHouse executable file.
+* `clickhouse-server` package contains configuration files to run ClickHouse as a server.
+
+Server config files are located in `/etc/clickhouse-server/`. Before going further please notice the `<path>` element in `config.xml`. Path determines the location for data storage, so it should be located on volume with large disk capacity, the default value is `/var/lib/clickhouse/`. If you want to adjust the configuration it's not really handy to directly edit `config.xml` file, considering it might get rewritten on future package updates. Recommended way to override the config elements is to create [files in config.d directory](../operations/configuration_files.md) which serve as "patches" to config.xml.
+
+As you might have noticed, `clickhouse-server` is not launched automatically after package installation. It won't be automatically restarted after updates either. The way you start the server depends on your init system, usually it's:
+
+``` bash
+sudo service clickhouse-server start
+```
+or
+
+``` bash
+sudo /etc/init.d/clickhouse-server start
+```
+
+The default location for server logs is `/var/log/clickhouse-server/`. Server will be ready to handle client connections once `Ready for connections` message was logged.
+
+Once the `clickhouse-server` is up and running, we can use `clickhouse-client` to connect to the server and run some test queries like `SELECT "Hello, world!";`.
+
+<details markdown="1"><summary>Quick tips for clickhouse-client</summary>
+Interactive mode:
+``` bash
+clickhouse-client
+clickhouse-client --host=... --port=... --user=... --password=...
+```
+
+Enable multiline queries:
+``` bash
+clickhouse-client -m
+clickhouse-client --multiline
+```
+
+Run queries in batch-mode:
+``` bash
+clickhouse-client --query='SELECT 1'
+echo 'SELECT 1' | clickhouse-client
+clickhouse-client <<< 'SELECT 1'
+```
+
+Insert data from a file in specified format:
+``` bash
+clickhouse-client --query='INSERT INTO table VALUES' < data.txt
+clickhouse-client --query='INSERT INTO table FORMAT TabSeparated' < data.tsv
+```
+</details>
+
+## Import Sample Dataset
+
+Now it's time to fill our ClickHouse server with some sample data. In this tutorial we'll use anonymized data of Yandex.Metrica, the first service that run ClickHouse in production way before it became open-source (more on that in [history section](../introduction/history.md)). There are [multiple ways to import Yandex.Metrica dataset](example_datasets/metrica.md) and for the sake of the tutorial we'll go with the most realistic one.
+
+### Download and Extract Table Data
+
+``` bash
+curl https://clickhouse-datasets.s3.yandex.net/hits/tsv/hits_v1.tsv.xz | unxz --threads=`nproc` > hits_v1.tsv
+curl https://clickhouse-datasets.s3.yandex.net/visits/tsv/visits_v1.tsv.xz | unxz --threads=`nproc` > visits_v1.tsv
+```
+
+The extracted files are about 10GB in size.
+
+### Create Tables
+
+Tables are logically grouped into "databases". There's a `default` database, but we'll create a new one named `tutorial`:
+
+``` bash
+clickhouse-client --query "CREATE DATABASE IF NOT EXISTS tutorial"
+```
+
+Syntax for creating tables is way more complicated compared to databases (see [reference](../query_language/create.md). In general `CREATE TABLE` statement has to specify three key things:
+
+1. Name of table to create.
+2. Table schema, i.e. list of columns and their [data types](../data_types/index.md).
+3. [Table engine](../operations/table_engines/index.md) and it's settings, which determines all the details on how queries to this table will be physically executed.
+
+Yandex.Metrica is a web analytics service and sample dataset doesn't cover it's full functionality, so there are only two tables to create:
+
+* `hits` is a table with each action done by all users on all websites covered by the service.
+* `visits` is a table that contains pre-built sessions instead of individual actions.
+
+Let's see and execute the real create table queries for these tables:
+
+``` sql
+CREATE TABLE tutorial.hits_v1
+(
+    `WatchID` UInt64,
+    `JavaEnable` UInt8,
+    `Title` String,
+    `GoodEvent` Int16,
+    `EventTime` DateTime,
+    `EventDate` Date,
+    `CounterID` UInt32,
+    `ClientIP` UInt32,
+    `ClientIP6` FixedString(16),
+    `RegionID` UInt32,
+    `UserID` UInt64,
+    `CounterClass` Int8,
+    `OS` UInt8,
+    `UserAgent` UInt8,
+    `URL` String,
+    `Referer` String,
+    `URLDomain` String,
+    `RefererDomain` String,
+    `Refresh` UInt8,
+    `IsRobot` UInt8,
+    `RefererCategories` Array(UInt16),
+    `URLCategories` Array(UInt16),
+    `URLRegions` Array(UInt32),
+    `RefererRegions` Array(UInt32),
+    `ResolutionWidth` UInt16,
+    `ResolutionHeight` UInt16,
+    `ResolutionDepth` UInt8,
+    `FlashMajor` UInt8,
+    `FlashMinor` UInt8,
+    `FlashMinor2` String,
+    `NetMajor` UInt8,
+    `NetMinor` UInt8,
+    `UserAgentMajor` UInt16,
+    `UserAgentMinor` FixedString(2),
+    `CookieEnable` UInt8,
+    `JavascriptEnable` UInt8,
+    `IsMobile` UInt8,
+    `MobilePhone` UInt8,
+    `MobilePhoneModel` String,
+    `Params` String,
+    `IPNetworkID` UInt32,
+    `TraficSourceID` Int8,
+    `SearchEngineID` UInt16,
+    `SearchPhrase` String,
+    `AdvEngineID` UInt8,
+    `IsArtifical` UInt8,
+    `WindowClientWidth` UInt16,
+    `WindowClientHeight` UInt16,
+    `ClientTimeZone` Int16,
+    `ClientEventTime` DateTime,
+    `SilverlightVersion1` UInt8,
+    `SilverlightVersion2` UInt8,
+    `SilverlightVersion3` UInt32,
+    `SilverlightVersion4` UInt16,
+    `PageCharset` String,
+    `CodeVersion` UInt32,
+    `IsLink` UInt8,
+    `IsDownload` UInt8,
+    `IsNotBounce` UInt8,
+    `FUniqID` UInt64,
+    `HID` UInt32,
+    `IsOldCounter` UInt8,
+    `IsEvent` UInt8,
+    `IsParameter` UInt8,
+    `DontCountHits` UInt8,
+    `WithHash` UInt8,
+    `HitColor` FixedString(1),
+    `UTCEventTime` DateTime,
+    `Age` UInt8,
+    `Sex` UInt8,
+    `Income` UInt8,
+    `Interests` UInt16,
+    `Robotness` UInt8,
+    `GeneralInterests` Array(UInt16),
+    `RemoteIP` UInt32,
+    `RemoteIP6` FixedString(16),
+    `WindowName` Int32,
+    `OpenerName` Int32,
+    `HistoryLength` Int16,
+    `BrowserLanguage` FixedString(2),
+    `BrowserCountry` FixedString(2),
+    `SocialNetwork` String,
+    `SocialAction` String,
+    `HTTPError` UInt16,
+    `SendTiming` Int32,
+    `DNSTiming` Int32,
+    `ConnectTiming` Int32,
+    `ResponseStartTiming` Int32,
+    `ResponseEndTiming` Int32,
+    `FetchTiming` Int32,
+    `RedirectTiming` Int32,
+    `DOMInteractiveTiming` Int32,
+    `DOMContentLoadedTiming` Int32,
+    `DOMCompleteTiming` Int32,
+    `LoadEventStartTiming` Int32,
+    `LoadEventEndTiming` Int32,
+    `NSToDOMContentLoadedTiming` Int32,
+    `FirstPaintTiming` Int32,
+    `RedirectCount` Int8,
+    `SocialSourceNetworkID` UInt8,
+    `SocialSourcePage` String,
+    `ParamPrice` Int64,
+    `ParamOrderID` String,
+    `ParamCurrency` FixedString(3),
+    `ParamCurrencyID` UInt16,
+    `GoalsReached` Array(UInt32),
+    `OpenstatServiceName` String,
+    `OpenstatCampaignID` String,
+    `OpenstatAdID` String,
+    `OpenstatSourceID` String,
+    `UTMSource` String,
+    `UTMMedium` String,
+    `UTMCampaign` String,
+    `UTMContent` String,
+    `UTMTerm` String,
+    `FromTag` String,
+    `HasGCLID` UInt8,
+    `RefererHash` UInt64,
+    `URLHash` UInt64,
+    `CLID` UInt32,
+    `YCLID` UInt64,
+    `ShareService` String,
+    `ShareURL` String,
+    `ShareTitle` String,
+    `ParsedParams` Nested(
+        Key1 String,
+        Key2 String,
+        Key3 String,
+        Key4 String,
+        Key5 String,
+        ValueDouble Float64),
+    `IslandID` FixedString(16),
+    `RequestNum` UInt32,
+    `RequestTry` UInt8
+)
+ENGINE = MergeTree()
+PARTITION BY toYYYYMM(EventDate)
+ORDER BY (CounterID, EventDate, intHash32(UserID))
+SAMPLE BY intHash32(UserID)
+SETTINGS index_granularity = 8192
+```
+
+``` sql
+CREATE TABLE tutorial.visits_v1
+(
+    `CounterID` UInt32,
+    `StartDate` Date,
+    `Sign` Int8,
+    `IsNew` UInt8,
+    `VisitID` UInt64,
+    `UserID` UInt64,
+    `StartTime` DateTime,
+    `Duration` UInt32,
+    `UTCStartTime` DateTime,
+    `PageViews` Int32,
+    `Hits` Int32,
+    `IsBounce` UInt8,
+    `Referer` String,
+    `StartURL` String,
+    `RefererDomain` String,
+    `StartURLDomain` String,
+    `EndURL` String,
+    `LinkURL` String,
+    `IsDownload` UInt8,
+    `TraficSourceID` Int8,
+    `SearchEngineID` UInt16,
+    `SearchPhrase` String,
+    `AdvEngineID` UInt8,
+    `PlaceID` Int32,
+    `RefererCategories` Array(UInt16),
+    `URLCategories` Array(UInt16),
+    `URLRegions` Array(UInt32),
+    `RefererRegions` Array(UInt32),
+    `IsYandex` UInt8,
+    `GoalReachesDepth` Int32,
+    `GoalReachesURL` Int32,
+    `GoalReachesAny` Int32,
+    `SocialSourceNetworkID` UInt8,
+    `SocialSourcePage` String,
+    `MobilePhoneModel` String,
+    `ClientEventTime` DateTime,
+    `RegionID` UInt32,
+    `ClientIP` UInt32,
+    `ClientIP6` FixedString(16),
+    `RemoteIP` UInt32,
+    `RemoteIP6` FixedString(16),
+    `IPNetworkID` UInt32,
+    `SilverlightVersion3` UInt32,
+    `CodeVersion` UInt32,
+    `ResolutionWidth` UInt16,
+    `ResolutionHeight` UInt16,
+    `UserAgentMajor` UInt16,
+    `UserAgentMinor` UInt16,
+    `WindowClientWidth` UInt16,
+    `WindowClientHeight` UInt16,
+    `SilverlightVersion2` UInt8,
+    `SilverlightVersion4` UInt16,
+    `FlashVersion3` UInt16,
+    `FlashVersion4` UInt16,
+    `ClientTimeZone` Int16,
+    `OS` UInt8,
+    `UserAgent` UInt8,
+    `ResolutionDepth` UInt8,
+    `FlashMajor` UInt8,
+    `FlashMinor` UInt8,
+    `NetMajor` UInt8,
+    `NetMinor` UInt8,
+    `MobilePhone` UInt8,
+    `SilverlightVersion1` UInt8,
+    `Age` UInt8,
+    `Sex` UInt8,
+    `Income` UInt8,
+    `JavaEnable` UInt8,
+    `CookieEnable` UInt8,
+    `JavascriptEnable` UInt8,
+    `IsMobile` UInt8,
+    `BrowserLanguage` UInt16,
+    `BrowserCountry` UInt16,
+    `Interests` UInt16,
+    `Robotness` UInt8,
+    `GeneralInterests` Array(UInt16),
+    `Params` Array(String),
+    `Goals` Nested(
+        ID UInt32,
+        Serial UInt32,
+        EventTime DateTime,
+        Price Int64,
+        OrderID String,
+        CurrencyID UInt32),
+    `WatchIDs` Array(UInt64),
+    `ParamSumPrice` Int64,
+    `ParamCurrency` FixedString(3),
+    `ParamCurrencyID` UInt16,
+    `ClickLogID` UInt64,
+    `ClickEventID` Int32,
+    `ClickGoodEvent` Int32,
+    `ClickEventTime` DateTime,
+    `ClickPriorityID` Int32,
+    `ClickPhraseID` Int32,
+    `ClickPageID` Int32,
+    `ClickPlaceID` Int32,
+    `ClickTypeID` Int32,
+    `ClickResourceID` Int32,
+    `ClickCost` UInt32,
+    `ClickClientIP` UInt32,
+    `ClickDomainID` UInt32,
+    `ClickURL` String,
+    `ClickAttempt` UInt8,
+    `ClickOrderID` UInt32,
+    `ClickBannerID` UInt32,
+    `ClickMarketCategoryID` UInt32,
+    `ClickMarketPP` UInt32,
+    `ClickMarketCategoryName` String,
+    `ClickMarketPPName` String,
+    `ClickAWAPSCampaignName` String,
+    `ClickPageName` String,
+    `ClickTargetType` UInt16,
+    `ClickTargetPhraseID` UInt64,
+    `ClickContextType` UInt8,
+    `ClickSelectType` Int8,
+    `ClickOptions` String,
+    `ClickGroupBannerID` Int32,
+    `OpenstatServiceName` String,
+    `OpenstatCampaignID` String,
+    `OpenstatAdID` String,
+    `OpenstatSourceID` String,
+    `UTMSource` String,
+    `UTMMedium` String,
+    `UTMCampaign` String,
+    `UTMContent` String,
+    `UTMTerm` String,
+    `FromTag` String,
+    `HasGCLID` UInt8,
+    `FirstVisit` DateTime,
+    `PredLastVisit` Date,
+    `LastVisit` Date,
+    `TotalVisits` UInt32,
+    `TraficSource` Nested(
+        ID Int8,
+        SearchEngineID UInt16,
+        AdvEngineID UInt8,
+        PlaceID UInt16,
+        SocialSourceNetworkID UInt8,
+        Domain String,
+        SearchPhrase String,
+        SocialSourcePage String),
+    `Attendance` FixedString(16),
+    `CLID` UInt32,
+    `YCLID` UInt64,
+    `NormalizedRefererHash` UInt64,
+    `SearchPhraseHash` UInt64,
+    `RefererDomainHash` UInt64,
+    `NormalizedStartURLHash` UInt64,
+    `StartURLDomainHash` UInt64,
+    `NormalizedEndURLHash` UInt64,
+    `TopLevelDomain` UInt64,
+    `URLScheme` UInt64,
+    `OpenstatServiceNameHash` UInt64,
+    `OpenstatCampaignIDHash` UInt64,
+    `OpenstatAdIDHash` UInt64,
+    `OpenstatSourceIDHash` UInt64,
+    `UTMSourceHash` UInt64,
+    `UTMMediumHash` UInt64,
+    `UTMCampaignHash` UInt64,
+    `UTMContentHash` UInt64,
+    `UTMTermHash` UInt64,
+    `FromHash` UInt64,
+    `WebVisorEnabled` UInt8,
+    `WebVisorActivity` UInt32,
+    `ParsedParams` Nested(
+        Key1 String,
+        Key2 String,
+        Key3 String,
+        Key4 String,
+        Key5 String,
+        ValueDouble Float64),
+    `Market` Nested(
+        Type UInt8,
+        GoalID UInt32,
+        OrderID String,
+        OrderPrice Int64,
+        PP UInt32,
+        DirectPlaceID UInt32,
+        DirectOrderID UInt32,
+        DirectBannerID UInt32,
+        GoodID String,
+        GoodName String,
+        GoodQuantity Int32,
+        GoodPrice Int64),
+    `IslandID` FixedString(16)
+)
+ENGINE = CollapsingMergeTree(Sign)
+PARTITION BY toYYYYMM(StartDate)
+ORDER BY (CounterID, StartDate, intHash32(UserID), VisitID)
+SAMPLE BY intHash32(UserID)
+SETTINGS index_granularity = 8192
+```
+
+You can execute those queries using interactive mode of `clickhouse-client` (just launch it in terminal without specifying a query in advance) or try some [alternative interface](../interfaces/index.md) if you ant.
+
+As we can see, `hits_v1` uses the [basic MergeTree engine](../operations/table_engines/mergetree.md), while the `visits_v1` uses the [Collapsing](../operations/table_engines/collapsingmergetree.md) variant.
+
+### Import Data
+
+Data import to ClickHouse is done via [INSERT INTO](../query_language/insert_into.md) query like in many other SQL databases. However data is usually provided in one of the [supported formats](../interfaces/formats.md) instead of `VALUES` clause (which is also supported).
+
+The files we downloaded earlier are in tab-separated format, so here's how to import them via console client:
+
+``` bash
+clickhouse-client --query "INSERT INTO tutorial.hits_v1 FORMAT TSV" --max_insert_block_size=100000 < hits_v1.tsv
+clickhouse-client --query "INSERT INTO tutorial.visits_v1 FORMAT TSV" --max_insert_block_size=100000 < visits_v1.tsv
+```
+
+ClickHouse has a lot of [settings to tune](../operations/settings/index.md) and one way to specify them in console client is via arguments, as we can see with `--max_insert_block_size`. The easiest way to figure out what settings are available, what do they mean and what the defaults are is to query the `system.settings` table:
+
+``` sql
+SELECT name, value, changed, description
+FROM system.settings
+WHERE name LIKE '%max_insert_b%'
+FORMAT TSV
+
+max_insert_block_size    1048576    0    "The maximum block size for insertion, if we control the creation of blocks for insertion."
+```
+
+Optionally you can [OPTIMIZE](../query_language/misc/#misc_operations-optimize) the tables after import. Tables that are configured with MergeTree-family engine always do merges of data parts in background to optimize data storage (or at least check if it makes sense). These queries will just force table engine to do storage optimization right now instead of some time later:
+``` bash
+clickhouse-client --query "OPTIMIZE TABLE tutorial.hits_v1 FINAL"
+clickhouse-client --query "OPTIMIZE TABLE tutorial.visits_v1 FINAL"
+```
+
+This is I/O and CPU intensive operation so if the table constantly receives new data it's better to leave it alone and let merges run in background.
+
+Now we can check that the tables are successfully imported:
+``` bash
+clickhouse-client --query "SELECT COUNT(*) FROM tutorial.hits_v1"
+clickhouse-client --query "SELECT COUNT(*) FROM tutorial.visits_v1"
+```
+
+## Example Queries
+
+``` sql
+SELECT
+    StartURL AS URL,
+    AVG(Duration) AS AvgDuration
+FROM tutorial.visits_v1
+WHERE StartDate BETWEEN '2014-03-23' AND '2014-03-30'
+GROUP BY URL
+ORDER BY AvgDuration DESC
+LIMIT 10
+```
+
+``` sql
+SELECT
+    sum(Sign) AS visits,
+    sumIf(Sign, has(Goals.ID, 1105530)) AS goal_visits,
+    (100. * goal_visits) / visits AS goal_percent
+FROM tutorial.visits_v1
+WHERE (CounterID = 912887) AND (toYYYYMM(StartDate) = 201403) AND (domain(StartURL) = 'yandex.ru')
+```
+
+## Cluster Deployment
+
+ClickHouse cluster is a homogenous cluster. Steps to set up:
+
+1. Install ClickHouse server on all machines of the cluster
+2. Set up cluster configs in configuration files
+3. Create local tables on each instance
+4. Create a [Distributed table](../operations/table_engines/distributed.md)
+
+[Distributed table](../operations/table_engines/distributed.md) is actually a kind of "view" to local tables of ClickHouse cluster. SELECT query from a distributed table will be executed using resources of all cluster's shards. You may specify configs for multiple clusters and create multiple distributed tables providing views to different clusters.
+
+Example config for cluster with three shards, one replica each:
+``` xml
+<remote_servers>
+    <perftest_3shards_1replicas>
+        <shard>
+            <replica>
+                <host>example-perftest01j.yandex.ru</host>
+                <port>9000</port>
+            </replica>
+        </shard>
+        <shard>
+            <replica>
+                <host>example-perftest02j.yandex.ru</host>
+                <port>9000</port>
+            </replica>
+        </shard>
+        <shard>
+            <replica>
+                <host>example-perftest03j.yandex.ru</host>
+                <port>9000</port>
+            </replica>
+        </shard>
+    </perftest_3shards_1replicas>
+</remote_servers>
+```
+
+For further demonstration let's create new local table with exactly the same `CREATE TABLE` query that we used for `hits_v1`, but different table name:
+``` sql
+CREATE TABLE tutorial.hits_local (...) ENGINE = MergeTree() ...
+```
+
+Creating a distributed table providing a view into local tables of the cluster:
+``` sql
+CREATE TABLE tutorial.hits_all AS tutorial.hits_local
+ENGINE = Distributed(perftest_3shards_1replicas, tutorial, hits_local, rand());
+```
+
+Common practice is to create similar Distributed tables on all machines of the cluster. This would allow to run distributed queries on any machine of the cluster. Also there's an alternative option to create temporary distributed table for a given SELECT query using [remote](../query_language/table_functions/remote.md) table function.
+
+Let's run [INSERT SELECT](../query_language/insert_into.md) into Distributed table to spread the table to multiple servers.
+
+``` sql
+INSERT INTO tutorial.hits_all SELECT * FROM tutorial.hits_v1;
+```
+
+!!! warning "Notice"
+    This approach is not suitable for sharding of large tables. There's a separate tool [clickhouse-copier](../operations/utils/clickhouse-copier.md) that can re-shard arbitrary large tables.
+
+As you could expect computationally heavy queries are executed N times faster being launched on 3 servers instead of one.
+
+In this case we have used a cluster with 3 shards each contains a single replica.
+
+To provide resilience in production environment we recommend that each shard should contain 2-3 replicas distributed between multiple data-centers. Note that ClickHouse supports unlimited number of replicas.
+
+Example config for cluster of one shard containing three replicas:
+``` xml
+<remote_servers>
+    ...
+    <perftest_1shards_3replicas>
+        <shard>
+            <replica>
+                <host>example-perftest01j.yandex.ru</host>
+                <port>9000</port>
+             </replica>
+             <replica>
+                <host>example-perftest02j.yandex.ru</host>
+                <port>9000</port>
+             </replica>
+             <replica>
+                <host>example-perftest03j.yandex.ru</host>
+                <port>9000</port>
+             </replica>
+        </shard>
+    </perftest_1shards_3replicas>
+</remote_servers>
+```
+
+To enable native replication <a href="http://zookeeper.apache.org/" rel="external nofollow">ZooKeeper</a> is required. ClickHouse will take care of data consistency on all replicas and run restore procedure after failure
+        automatically. It's recommended to deploy ZooKeeper cluster to separate servers.
+
+ZooKeeper is not a strict requirement: in some simple cases you can duplicate the data by writing it into all the replicas from your application code. This approach is **not** recommended, in this case ClickHouse won't be able to
+        guarantee data consistency on all replicas. This remains the responsibility of your application.
+
+ZooKeeper locations need to be specified in configuration file:
+``` xml
+<zookeeper-servers>
+    <node>
+        <host>zoo01.yandex.ru</host>
+        <port>2181</port>
+    </node>
+    <node>
+        <host>zoo02.yandex.ru</host>
+        <port>2181</port>
+    </node>
+    <node>
+        <host>zoo03.yandex.ru</host>
+        <port>2181</port>
+    </node>
+</zookeeper-servers>
+```
+
+Also we need to set macros for identifying each shard and replica, it will be used on table creation:
+``` xml
+<macros>
+    <shard>01</shard>
+    <replica>01</replica>
+</macros>
+```
+
+If there are no replicas at the moment on replicated table creation, a new first replica will be instantiated. If there are already live replicas, new replica will clone the data from existing ones. You have an option to create all replicated tables first and that insert data to it. Another option is to create some replicas and add the others after or during data insertion.
+
+``` sql
+CREATE TABLE tutorial.hits_replica (...)
+ENGINE = ReplcatedMergeTree(
+    '/clickhouse_perftest/tables/{shard}/hits',
+    '{replica}'
+)
+...
+```
+
+Here we use [ReplicatedMergeTree](../operations/table_engines/replication.md) table engine. In parameters we specify ZooKeeper path containing shard and replica identifiers.
+
+``` sql
+INSERT INTO tutorial.hits_replica SELECT * FROM tutorial.hits_local;
+```
+Replication operates in multi-master mode. Data can be loaded into any replica and it will be synced with other instances automatically. Replication is asynchronous so at a given moment of time not all replicas may contain recently inserted data. To allow data insertion at least one replica should be up. Others will sync up data and repair consistency once they will become active again. Please notice that such approach allows for the low possibility of loss of just appended data.
diff --git a/docs/en/introduction/ya_metrika_task.md b/docs/en/introduction/history.md
similarity index 98%
rename from docs/en/introduction/ya_metrika_task.md
rename to docs/en/introduction/history.md
index 41b33eff581..e8f373880f1 100644
--- a/docs/en/introduction/ya_metrika_task.md
+++ b/docs/en/introduction/history.md
@@ -1,4 +1,4 @@
-# Yandex.Metrica Use Case
+# ClickHouse History
 
 ClickHouse was originally developed to power [Yandex.Metrica](https://metrica.yandex.com/), [the second largest web analytics platform in the world](http://w3techs.com/technologies/overview/traffic_analysis/all), and continues to be the core component of this system. With more than 13 trillion records in the database and more than 20 billion events daily, ClickHouse allows generating custom reports on the fly directly from non-aggregated data. This article briefly covers the goals of ClickHouse in the early stages of its development.
 
@@ -47,4 +47,4 @@ OLAPServer worked well for non-aggregated data, but it had many restrictions tha
 To remove the limitations of OLAPServer and solve the problem of working with non-aggregated data for all reports, we developed the ClickHouse DBMS.
 
 
-[Original article](https://clickhouse.yandex/docs/en/introduction/ya_metrika_task/) <!--hide-->
+[Original article](https://clickhouse.yandex/docs/en/introduction/history/) <!--hide-->
diff --git a/docs/fa/getting_started/index.md b/docs/fa/getting_started/index.md
index 778393aed91..57496c474e2 100644
--- a/docs/fa/getting_started/index.md
+++ b/docs/fa/getting_started/index.md
@@ -1,197 +1,11 @@
 <div dir="rtl" markdown="1">
+# ﻥﺪﺷ ﻉﻭﺮﺷ
 
-# شروع به کار
+ﻖﯾﺮﻃ ﺯﺍ ﺪﯾﺎﺑ ﻪﻤﻫ ﺯﺍ ﻝﻭﺍ ، ﺪﯿﻨﮐ ﺱﺎﺴﺣﺍ ﺍﺭ ﻥﺁ ﺩﺮﮑﻠﻤﻋ ﺪﯿﻫﺍﻮﺧ ﯽﻣ ﻭ ﺪﯿﺘﺴﻫ ﺩﺭﺍﻭ ﻩﺯﺎﺗ[ﺐﺼﻧ ﻞﺣﺍﺮﻣ](install.md).
+ﺪﯿﻨﮐ ﺏﺎﺨﺘﻧﺍ ﺍﺭ ﺮﯾﺯ ﯼﺎﻫ ﻪﻨﯾﺰﮔ ﺯﺍ ﯽﮑﯾ ﺪﯿﻧﺍﻮﺗ ﯽﻣ ﻥﺁ ﺯﺍ ﺲﭘ:
 
-## نیازمندی های سیستم
-
-این یک سیستم چند سکویی (Cross-Platform) نمی باشد. این ابزار نیاز به Linux Ubuntu Precise (12.04) یا جدیدتر، با معماری x86\_64 و پشتیبانی از SSE 4.2 می باشد. برای چک کردن SSE 4.2 خروجی دستور زیر را بررسی کنید:
+* [ﺪﯿﻨﮐ ﯽﻃ ﺍﺭ ﻞﺼﻔﻣ ﺵﺯﻮﻣﺁ](tutorial.md)
+* [ﺪﯿﻨﮐ ﺶﯾﺎﻣﺯﺁ ﻪﻧﻮﻤﻧ ﯼﺎﻫ ﻩﺩﺍﺩ ﺎﺑ](example_datasets/ontime.md)
 
+[ﯽﻠﺻﺍ ﻪﻟﺎﻘﻣ](https://clickhouse.yandex/docs/fa/getting_started/) <!--hide-->
 </div>
-
-```bash
-grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
-```
-
-<div dir="rtl" markdown="1">
-
-پیشنهاد می کنیم از Ubuntu TrustyT، Ubuntu Xenial یا Ubuntu Precise استفاده کنید. ترمینال باید از UTF-8 پشتیبانی کند. (به صورت پیش فرض در Ubuntu پشتیبانی می شود).
-
-## نصب
-
-### نصب از طریق پکیج های Debian/Ubuntu
-
-در فایل `/etc/apt/sources.list` (یا در یک فایل جدا `/etc/apt/sources.list.d/clickhouse.list`)، Repo زیر را اضافه کنید:
-
-</div>
-
-```
-deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
-```
-
-<div dir="rtl" markdown="1">
-
-اگر شما میخوایید جدیدترین نسخه ی تست را استفاده کنید، 'stable' رو به 'testing' تغییر بدید.
-
-سپس دستورات زیر را اجرا کنید:
-
-</div>
-
-```bash
-sudo apt-get install dirmngr    # optional
-sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
-sudo apt-get update
-sudo apt-get install clickhouse-client clickhouse-server
-```
-
-<div dir="rtl" markdown="1">
-
-شما همچنین می توانید از طریق لینک زیر پکیج ClickHouse را به صورت دستی دانلود و نصب کنید: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
-
-ClickHouse دارای تنظیمات محدودیت دسترسی می باشد. این تنظیمات در فایل 'users.xml' (کنار 'config.xml') می باشد. به صورت پیش فرض دسترسی برای کاربر 'default' از همه جا بدون نیاز به پسورد وجود دارد. 'user/default/networks' را مشاهده کنید. برای اطلاعات بیشتر قسمت "تنظیمات فایل ها" را مشاهده کنید.
-
-                                                           RPM ﯼﺎﻫ ﻪﺘﺴﺑ ﺯﺍ ###
-
-.ﺪﻨﮐ ﯽﻣ ﻪﯿﺻﻮﺗ ﺲﮐﻮﻨﯿﻟ ﺮﺑ ﯽﻨﺘﺒﻣ rpm ﺮﺑ ﯽﻨﺘﺒﻣ ﯼﺎﻫ ﻊﯾﺯﻮﺗ ﺮﯾﺎﺳ ﻭ CentOS ، RedHat ﯼﺍ
-
-                                           :ﺪﯿﻨﮐ ﻪﻓﺎﺿﺍ ﺍﺭ ﯽﻤﺳﺭ ﻥﺰﺨﻣ ﺪﯾﺎﺑ ﺍﺪﺘﺑﺍ
-
-```bash
-sudo yum install yum-utils
-sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
-sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
-```
-
-.(ﺩﻮﺷ ﯽﻣ ﻪﯿﺻﻮﺗ ﺎﻤﺷ ﺶﯾﺎﻣﺯﺁ ﯼﺎﻫ ﻂﯿﺤﻣ ﯼﺍﺮﺑ ﻦﯾﺍ) ﺪﯿﻨﮐ ﻦﯾﺰﮕﯾﺎﺟ "ﺖﺴﺗ" ﺎﺑ ﺍﺭ "ﺭﺍﺪﯾﺎﭘ"
-
-                  :ﺪﯿﻨﮐ ﺐﺼﻧ ﺍﺭ ﺎﻫ ﻪﺘﺴﺑ ﻊﻗﺍﻭ ﺭﺩ ﺎﺗ ﺪﯿﻨﮐ ﺍﺮﺟﺍ ﺍﺭ ﺕﺍﺭﻮﺘﺳﺩ ﻦﯾﺍ ﺲﭙﺳ
-
-```bash
-sudo yum install clickhouse-server clickhouse-client
-```
-
-.<https://repo.yandex.ru/clickhouse/rpm/stable/x86_64> :ﺪﯿﻨﮐ ﺐﺼﻧ ﻭ ﯼﺮﯿﮔﺭﺎﺑ ﺎﺠﻨ
-
-                                                           Docker Image ﺯﺍ ###
-
-.ﺪﻨﻨﮐ ﯽﻣ ﻩﺩﺎﻔﺘﺳﺍ ﻞﺧﺍﺩ ﺭﺩ "deb" ﯽﻤﺳﺭ ﯼﺎﻫ ﻪﺘﺴﺑ ﺯﺍ ﺮﯾﻭﺎﺼﺗ ﻦﯾﺍ .ﺪﯿﻨﮐ ﻝﺎﺒﻧﺩ ﺍﺭ (/ht
-
-
-### نصب از طریق Source
-
-برای Compile، دستورالعمل های فایل build.md را دنبال کنید:
-
-شما میتوانید پکیج را compile و نصب کنید. شما همچنین می توانید بدون نصب پکیج از برنامه ها استفاده کنید.
-
-</div>
-
-```
-Client: dbms/programs/clickhouse-client
-Server: dbms/programs/clickhouse-server
-```
-
-<div dir="rtl" markdown="1">
-
-برای سرور، یک کاتالوگ با دیتا بسازید، مانند
-
-</div>
-
-```
-/opt/clickhouse/data/default/
-/opt/clickhouse/metadata/default/
-```
-
-<div dir="rtl" markdown="1">
-
-(قابل تنظیم در تنظیمات سرور). 'chown' را برای کاربر دلخواه اجرا کنید.
-
-به مسیر لاگ ها در تنظیمات سرور توجه کنید (src/dbms/programs/config.xml).
-
-### روش های دیگر نصب
-
-Docker image: <https://hub.docker.com/r/yandex/clickhouse-server/>
-
-پکیج RPM برای CentOS یا RHEL: <https://github.com/Altinity/clickhouse-rpm-install>
-
-Gentoo: `emerge clickhouse`
-
-## راه اندازی
-
-برای استارت سرور (به صورت daemon)، دستور زیر را اجرا کنید:
-
-</div>
-
-```bash
-sudo service clickhouse-server start
-```
-
-<div dir="rtl" markdown="1">
-
-لاگ های دایرکتوری `/var/log/clickhouse-server/` directory. را مشاهده کنید.
-
-اگر سرور استارت نشد، فایل تنظیمات را بررسی کنید `/etc/clickhouse-server/config.xml.`
-
-شما همچنین می توانید سرور را از طریق کنسول راه اندازی کنید:
-
-</div>
-
-```bash
-clickhouse-server --config-file=/etc/clickhouse-server/config.xml
-```
-
-<div dir="rtl" markdown="1">
-
-در این مورد که مناسب زمان توسعه می باشد، لاگ ها در کنسول پرینت می شوند. اگر فایل تنظیمات در دایرکتوری جاری باشد، نیازی به مشخص کردن '--config-file' نمی باشد. به صورت پیش فرض از './config.xml' استفاده می شود.
-
-شما می توانید از کلاینت command-line برای اتصال به سرور استفاده کنید:
-
-</div>
-
-```bash
-clickhouse-client
-```
-
-<div dir="rtl" markdown="1">
-
-پارامترهای پیش فرض، نشان از اتصال به localhost:9000 از طرف کاربر 'default' بدون پسورد را می دهد. از کلاینت میتوان برای اتصال به یک سرور remote استفاده کرد. مثال:
-
-</div>
-
-```bash
-clickhouse-client --host=example.com
-```
-
-<div dir="rtl" markdown="1">
-
-برای اطلاعات بیشتر، بخش "کلاینت Command-line" را مشاهده کنید.
-
-چک کردن سیستم:
-
-</div>
-
-```bash
-milovidov@hostname:~/work/metrica/src/dbms/src/Client$ ./clickhouse-client
-ClickHouse client version 0.0.18749.
-Connecting to localhost:9000.
-Connected to ClickHouse server version 0.0.18749.
-
-:) SELECT 1
-
-SELECT 1
-
-┌─1─┐
-│ 1 │
-└───┘
-
-1 rows in set. Elapsed: 0.003 sec.
-
-:)
-```
-
-<div dir="rtl" markdown="1">
-
-**تبریک میگم، سیستم کار می کنه!**
-
-برای ادامه آزمایشات، شما میتوانید دیتاست های تستی را دریافت و امتحان کنید.
-
-</div>
-[مقاله اصلی](https://clickhouse.yandex/docs/fa/getting_started/) <!--hide-->
diff --git a/docs/fa/getting_started/install.md b/docs/fa/getting_started/install.md
new file mode 100644
index 00000000000..790c9381007
--- /dev/null
+++ b/docs/fa/getting_started/install.md
@@ -0,0 +1,199 @@
+<div dir="rtl" markdown="1">
+
+# ﯼﺯﺍﺪﻧﺍ ﻩﺍﺭ ﻭ ﺐﺼﻧ
+
+## نیازمندی های سیستم
+
+ClickHouse ﺲﮐﻮﻨﯿﻟ ﻉﻮﻧ ﺮﻫ ﯼﻭﺭ ﺮﺑ ﺪﻧﺍﻮﺗ ﯽﻣ ، FreeBSD ﺎﯾ Mac OS X ﯼﺭﺎﻤﻌﻣ ﺎﺑ CPU x
+
+:ﺖﺳﺍ ﻩﺪﻣﺁ ، ﺪﻨﮐ ﯽﻣ ﯽﻧﺎﺒﯿﺘﺸﭘ SSE 4.2 ﺯﺍ ﯽﻠﻌﻓ CPU ﺎﯾﺁ ﻪﮑﻨﯾﺍ ﯽﺳﺭﺮﺑ ﯼﺍﺮﺑ ﺭﻮﺘﺳﺩ ﻦﯾﺍ
+
+</div>
+
+```bash
+grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
+```
+
+<div dir="rtl" markdown="1">
+
+ﺪﯾﺎﺑ ، ﺪﻧﺭﺍﺪﻧ PowerPC64LE ﺎﯾ AArch64 ﯼﺭﺎﻤﻌﻣ ﺎﯾ ﺪﻨﻨﮐ ﯽﻤﻧ ﯽﻧﺎﺒﯿﺘﺸﭘ SSE 4.2 ﺯﺍ ﻪﮐ[ClickHouse ﺪﯿﻨﮐ ﺩﺎﺠﯾﺍ ﻊﺑﺎﻨﻣ ﺯﺍ ﺍﺭ](#from-sources) ﺐﺳﺎﻨﻣ ﺕﺎﻤﯿﻈﻨﺗ ﺎﺑ
+
+##ﺩﻮﺟﻮﻣ ﺐﺼﻧ ﯼﺎﻫ ﻪﻨﯾﺰﮔ
+
+### نصب از طریق پکیج های Debian/Ubuntu {#from-deb-packages}
+
+در فایل `/etc/apt/sources.list` (یا در یک فایل جدا `/etc/apt/sources.list.d/clickhouse.list`)، Repo زیر را اضافه کنید:
+
+</div>
+
+```
+deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
+```
+
+<div dir="rtl" markdown="1">
+
+اگر شما میخوایید جدیدترین نسخه ی تست را استفاده کنید، 'stable' رو به 'testing' تغییر بدید.
+
+سپس دستورات زیر را اجرا کنید:
+
+</div>
+
+```bash
+sudo apt-get install dirmngr    # optional
+sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
+sudo apt-get update
+sudo apt-get install clickhouse-client clickhouse-server
+```
+
+<div dir="rtl" markdown="1">
+
+شما همچنین می توانید از طریق لینک زیر پکیج ClickHouse را به صورت دستی دانلود و نصب کنید: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
+
+ClickHouse دارای تنظیمات محدودیت دسترسی می باشد. این تنظیمات در فایل 'users.xml' (کنار 'config.xml') می باشد. به صورت پیش فرض دسترسی برای کاربر 'default' از همه جا بدون نیاز به پسورد وجود دارد. 'user/default/networks' را مشاهده کنید. برای اطلاعات بیشتر قسمت "تنظیمات فایل ها" را مشاهده کنید.
+
+### RPM ﯼﺎﻫ ﻪﺘﺴﺑ ﺯﺍ {#from-rpm-packages}
+
+.ﺪﻨﮐ ﯽﻣ ﻪﯿﺻﻮﺗ ﺲﮐﻮﻨﯿﻟ ﺮﺑ ﯽﻨﺘﺒﻣ rpm ﺮﺑ ﯽﻨﺘﺒﻣ ﯼﺎﻫ ﻊﯾﺯﻮﺗ ﺮﯾﺎﺳ ﻭ CentOS ، RedHat ﯼﺍ
+
+                                           :ﺪﯿﻨﮐ ﻪﻓﺎﺿﺍ ﺍﺭ ﯽﻤﺳﺭ ﻥﺰﺨﻣ ﺪﯾﺎﺑ ﺍﺪﺘﺑﺍ
+
+```bash
+sudo yum install yum-utils
+sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
+sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
+```
+
+.(ﺩﻮﺷ ﯽﻣ ﻪﯿﺻﻮﺗ ﺎﻤﺷ ﺶﯾﺎﻣﺯﺁ ﯼﺎﻫ ﻂﯿﺤﻣ ﯼﺍﺮﺑ ﻦﯾﺍ) ﺪﯿﻨﮐ ﻦﯾﺰﮕﯾﺎﺟ "ﺖﺴﺗ" ﺎﺑ ﺍﺭ "ﺭﺍﺪﯾﺎﭘ"
+
+                  :ﺪﯿﻨﮐ ﺐﺼﻧ ﺍﺭ ﺎﻫ ﻪﺘﺴﺑ ﻊﻗﺍﻭ ﺭﺩ ﺎﺗ ﺪﯿﻨﮐ ﺍﺮﺟﺍ ﺍﺭ ﺕﺍﺭﻮﺘﺳﺩ ﻦﯾﺍ ﺲﭙﺳ
+
+```bash
+sudo yum install clickhouse-server clickhouse-client
+```
+
+.<https://repo.yandex.ru/clickhouse/rpm/stable/x86_64> :ﺪﯿﻨﮐ ﺐﺼﻧ ﻭ ﯼﺮﯿﮔﺭﺎﺑ ﺎﺠﻨ
+
+                                                           Docker Image ﺯﺍ ###
+
+.ﺪﻨﻨﮐ ﯽﻣ ﻩﺩﺎﻔﺘﺳﺍ ﻞﺧﺍﺩ ﺭﺩ "deb" ﯽﻤﺳﺭ ﯼﺎﻫ ﻪﺘﺴﺑ ﺯﺍ ﺮﯾﻭﺎﺼﺗ ﻦﯾﺍ .ﺪﯿﻨﮐ ﻝﺎﺒﻧﺩ ﺍﺭ (/ht
+
+
+### نصب از طریق Source {#from-sources}
+
+برای Compile، دستورالعمل های فایل build.md را دنبال کنید:
+
+شما میتوانید پکیج را compile و نصب کنید. شما همچنین می توانید بدون نصب پکیج از برنامه ها استفاده کنید.
+
+</div>
+
+```
+Client: dbms/programs/clickhouse-client
+Server: dbms/programs/clickhouse-server
+```
+
+<div dir="rtl" markdown="1">
+
+برای سرور، یک کاتالوگ با دیتا بسازید، مانند
+
+</div>
+
+```
+/opt/clickhouse/data/default/
+/opt/clickhouse/metadata/default/
+```
+
+<div dir="rtl" markdown="1">
+
+(قابل تنظیم در تنظیمات سرور). 'chown' را برای کاربر دلخواه اجرا کنید.
+
+به مسیر لاگ ها در تنظیمات سرور توجه کنید (src/dbms/programs/config.xml).
+
+### روش های دیگر نصب {#from-docker-image}
+
+Docker image: <https://hub.docker.com/r/yandex/clickhouse-server/>
+
+پکیج RPM برای CentOS یا RHEL: <https://github.com/Altinity/clickhouse-rpm-install>
+
+Gentoo: `emerge clickhouse`
+
+## راه اندازی
+
+برای استارت سرور (به صورت daemon)، دستور زیر را اجرا کنید:
+
+</div>
+
+```bash
+sudo service clickhouse-server start
+```
+
+<div dir="rtl" markdown="1">
+
+لاگ های دایرکتوری `/var/log/clickhouse-server/` directory. را مشاهده کنید.
+
+اگر سرور استارت نشد، فایل تنظیمات را بررسی کنید `/etc/clickhouse-server/config.xml.`
+
+شما همچنین می توانید سرور را از طریق کنسول راه اندازی کنید:
+
+</div>
+
+```bash
+clickhouse-server --config-file=/etc/clickhouse-server/config.xml
+```
+
+<div dir="rtl" markdown="1">
+
+در این مورد که مناسب زمان توسعه می باشد، لاگ ها در کنسول پرینت می شوند. اگر فایل تنظیمات در دایرکتوری جاری باشد، نیازی به مشخص کردن '--config-file' نمی باشد. به صورت پیش فرض از './config.xml' استفاده می شود.
+
+شما می توانید از کلاینت command-line برای اتصال به سرور استفاده کنید:
+
+</div>
+
+```bash
+clickhouse-client
+```
+
+<div dir="rtl" markdown="1">
+
+پارامترهای پیش فرض، نشان از اتصال به localhost:9000 از طرف کاربر 'default' بدون پسورد را می دهد. از کلاینت میتوان برای اتصال به یک سرور remote استفاده کرد. مثال:
+
+</div>
+
+```bash
+clickhouse-client --host=example.com
+```
+
+<div dir="rtl" markdown="1">
+
+برای اطلاعات بیشتر، بخش "کلاینت Command-line" را مشاهده کنید.
+
+چک کردن سیستم:
+
+</div>
+
+```bash
+milovidov@hostname:~/work/metrica/src/dbms/src/Client$ ./clickhouse-client
+ClickHouse client version 0.0.18749.
+Connecting to localhost:9000.
+Connected to ClickHouse server version 0.0.18749.
+
+:) SELECT 1
+
+SELECT 1
+
+┌─1─┐
+│ 1 │
+└───┘
+
+1 rows in set. Elapsed: 0.003 sec.
+
+:)
+```
+
+<div dir="rtl" markdown="1">
+
+**تبریک میگم، سیستم کار می کنه!**
+
+برای ادامه آزمایشات، شما میتوانید دیتاست های تستی را دریافت و امتحان کنید.
+
+</div>
+[مقاله اصلی](https://clickhouse.yandex/docs/fa/getting_started/install/) <!--hide-->
diff --git a/docs/fa/getting_started/tutorial.md b/docs/fa/getting_started/tutorial.md
new file mode 120000
index 00000000000..8bc40816ab2
--- /dev/null
+++ b/docs/fa/getting_started/tutorial.md
@@ -0,0 +1 @@
+../../en/getting_started/tutorial.md
\ No newline at end of file
diff --git a/docs/fa/introduction/ya_metrika_task.md b/docs/fa/introduction/history.md
similarity index 99%
rename from docs/fa/introduction/ya_metrika_task.md
rename to docs/fa/introduction/history.md
index 1ea434f248c..abde10aa6f3 100644
--- a/docs/fa/introduction/ya_metrika_task.md
+++ b/docs/fa/introduction/history.md
@@ -1,6 +1,6 @@
 <div dir="rtl" markdown="1">
 
-# Yandex.Metrica use case
+# ClickHouse ﻪﭽﺨﯾﺭﺎﺗ
 
 ClickHouse در ابتدا برای قدرت به Yandex.Metrica دومین بستر آنالیز وب در دنیا توسعه داده شد، و همچنان جز اصلی آن است. ClickHouse اجازه می دهند که با بیش از 13 تریلیون رکورد در دیتابیس و بیش از 20 میلیارد event در روز، گزارش های مستقیم (On the fly) از داده های non-aggregate تهیه کنیم. این مقاله پیشنیه ی تاریخی در ارتباط با اهداف اصلی ClickHouse قبل از آنکه به یک محصول open source تبدیل شود، می دهد.
 
diff --git a/docs/ja/changelog.md b/docs/ja/changelog.md
new file mode 120000
index 00000000000..699cc9e7b7c
--- /dev/null
+++ b/docs/ja/changelog.md
@@ -0,0 +1 @@
+../../CHANGELOG.md
\ No newline at end of file
diff --git a/docs/ja/data_types/array.md b/docs/ja/data_types/array.md
new file mode 120000
index 00000000000..808c98bf91a
--- /dev/null
+++ b/docs/ja/data_types/array.md
@@ -0,0 +1 @@
+../../en/data_types/array.md
\ No newline at end of file
diff --git a/docs/ja/data_types/boolean.md b/docs/ja/data_types/boolean.md
new file mode 120000
index 00000000000..42e84f1e52a
--- /dev/null
+++ b/docs/ja/data_types/boolean.md
@@ -0,0 +1 @@
+../../en/data_types/boolean.md
\ No newline at end of file
diff --git a/docs/ja/data_types/date.md b/docs/ja/data_types/date.md
new file mode 120000
index 00000000000..d1ebc137e8f
--- /dev/null
+++ b/docs/ja/data_types/date.md
@@ -0,0 +1 @@
+../../en/data_types/date.md
\ No newline at end of file
diff --git a/docs/ja/data_types/datetime.md b/docs/ja/data_types/datetime.md
new file mode 120000
index 00000000000..2eb9f44e6eb
--- /dev/null
+++ b/docs/ja/data_types/datetime.md
@@ -0,0 +1 @@
+../../en/data_types/datetime.md
\ No newline at end of file
diff --git a/docs/ja/data_types/decimal.md b/docs/ja/data_types/decimal.md
new file mode 120000
index 00000000000..ccea440adfa
--- /dev/null
+++ b/docs/ja/data_types/decimal.md
@@ -0,0 +1 @@
+../../en/data_types/decimal.md
\ No newline at end of file
diff --git a/docs/ja/data_types/domains/ipv4.md b/docs/ja/data_types/domains/ipv4.md
new file mode 120000
index 00000000000..eb4cc7d57b5
--- /dev/null
+++ b/docs/ja/data_types/domains/ipv4.md
@@ -0,0 +1 @@
+../../../en/data_types/domains/ipv4.md
\ No newline at end of file
diff --git a/docs/ja/data_types/domains/ipv6.md b/docs/ja/data_types/domains/ipv6.md
new file mode 120000
index 00000000000..cca37a22458
--- /dev/null
+++ b/docs/ja/data_types/domains/ipv6.md
@@ -0,0 +1 @@
+../../../en/data_types/domains/ipv6.md
\ No newline at end of file
diff --git a/docs/ja/data_types/domains/overview.md b/docs/ja/data_types/domains/overview.md
new file mode 120000
index 00000000000..13465d655ee
--- /dev/null
+++ b/docs/ja/data_types/domains/overview.md
@@ -0,0 +1 @@
+../../../en/data_types/domains/overview.md
\ No newline at end of file
diff --git a/docs/ja/data_types/enum.md b/docs/ja/data_types/enum.md
new file mode 120000
index 00000000000..23ebe64773e
--- /dev/null
+++ b/docs/ja/data_types/enum.md
@@ -0,0 +1 @@
+../../en/data_types/enum.md
\ No newline at end of file
diff --git a/docs/ja/data_types/fixedstring.md b/docs/ja/data_types/fixedstring.md
new file mode 120000
index 00000000000..53092fcb884
--- /dev/null
+++ b/docs/ja/data_types/fixedstring.md
@@ -0,0 +1 @@
+../../en/data_types/fixedstring.md
\ No newline at end of file
diff --git a/docs/ja/data_types/float.md b/docs/ja/data_types/float.md
new file mode 120000
index 00000000000..d2ae6bd11de
--- /dev/null
+++ b/docs/ja/data_types/float.md
@@ -0,0 +1 @@
+../../en/data_types/float.md
\ No newline at end of file
diff --git a/docs/ja/data_types/index.md b/docs/ja/data_types/index.md
new file mode 120000
index 00000000000..c9f29d637f3
--- /dev/null
+++ b/docs/ja/data_types/index.md
@@ -0,0 +1 @@
+../../en/data_types/index.md
\ No newline at end of file
diff --git a/docs/ja/data_types/int_uint.md b/docs/ja/data_types/int_uint.md
new file mode 120000
index 00000000000..3a913c9328e
--- /dev/null
+++ b/docs/ja/data_types/int_uint.md
@@ -0,0 +1 @@
+../../en/data_types/int_uint.md
\ No newline at end of file
diff --git a/docs/ja/data_types/nested_data_structures/aggregatefunction.md b/docs/ja/data_types/nested_data_structures/aggregatefunction.md
new file mode 120000
index 00000000000..36544324d2b
--- /dev/null
+++ b/docs/ja/data_types/nested_data_structures/aggregatefunction.md
@@ -0,0 +1 @@
+../../../en/data_types/nested_data_structures/aggregatefunction.md
\ No newline at end of file
diff --git a/docs/ja/data_types/nested_data_structures/index.md b/docs/ja/data_types/nested_data_structures/index.md
new file mode 120000
index 00000000000..a5659a9c5cd
--- /dev/null
+++ b/docs/ja/data_types/nested_data_structures/index.md
@@ -0,0 +1 @@
+../../../en/data_types/nested_data_structures/index.md
\ No newline at end of file
diff --git a/docs/ja/data_types/nested_data_structures/nested.md b/docs/ja/data_types/nested_data_structures/nested.md
new file mode 120000
index 00000000000..653a1ce31c3
--- /dev/null
+++ b/docs/ja/data_types/nested_data_structures/nested.md
@@ -0,0 +1 @@
+../../../en/data_types/nested_data_structures/nested.md
\ No newline at end of file
diff --git a/docs/ja/data_types/nullable.md b/docs/ja/data_types/nullable.md
new file mode 120000
index 00000000000..0233f91d954
--- /dev/null
+++ b/docs/ja/data_types/nullable.md
@@ -0,0 +1 @@
+../../en/data_types/nullable.md
\ No newline at end of file
diff --git a/docs/ja/data_types/special_data_types/expression.md b/docs/ja/data_types/special_data_types/expression.md
new file mode 120000
index 00000000000..4cec632b416
--- /dev/null
+++ b/docs/ja/data_types/special_data_types/expression.md
@@ -0,0 +1 @@
+../../../en/data_types/special_data_types/expression.md
\ No newline at end of file
diff --git a/docs/ja/data_types/special_data_types/index.md b/docs/ja/data_types/special_data_types/index.md
new file mode 120000
index 00000000000..f3ca4a47f98
--- /dev/null
+++ b/docs/ja/data_types/special_data_types/index.md
@@ -0,0 +1 @@
+../../../en/data_types/special_data_types/index.md
\ No newline at end of file
diff --git a/docs/ja/data_types/special_data_types/interval.md b/docs/ja/data_types/special_data_types/interval.md
new file mode 120000
index 00000000000..6829f5ced00
--- /dev/null
+++ b/docs/ja/data_types/special_data_types/interval.md
@@ -0,0 +1 @@
+../../../en/data_types/special_data_types/interval.md
\ No newline at end of file
diff --git a/docs/ja/data_types/special_data_types/nothing.md b/docs/ja/data_types/special_data_types/nothing.md
new file mode 120000
index 00000000000..197a752ce9c
--- /dev/null
+++ b/docs/ja/data_types/special_data_types/nothing.md
@@ -0,0 +1 @@
+../../../en/data_types/special_data_types/nothing.md
\ No newline at end of file
diff --git a/docs/ja/data_types/special_data_types/set.md b/docs/ja/data_types/special_data_types/set.md
new file mode 120000
index 00000000000..5beb14114d3
--- /dev/null
+++ b/docs/ja/data_types/special_data_types/set.md
@@ -0,0 +1 @@
+../../../en/data_types/special_data_types/set.md
\ No newline at end of file
diff --git a/docs/ja/data_types/string.md b/docs/ja/data_types/string.md
new file mode 120000
index 00000000000..7bdd739398f
--- /dev/null
+++ b/docs/ja/data_types/string.md
@@ -0,0 +1 @@
+../../en/data_types/string.md
\ No newline at end of file
diff --git a/docs/ja/data_types/tuple.md b/docs/ja/data_types/tuple.md
new file mode 120000
index 00000000000..d30a8463aeb
--- /dev/null
+++ b/docs/ja/data_types/tuple.md
@@ -0,0 +1 @@
+../../en/data_types/tuple.md
\ No newline at end of file
diff --git a/docs/ja/data_types/uuid.md b/docs/ja/data_types/uuid.md
new file mode 120000
index 00000000000..aba05e889ac
--- /dev/null
+++ b/docs/ja/data_types/uuid.md
@@ -0,0 +1 @@
+../../en/data_types/uuid.md
\ No newline at end of file
diff --git a/docs/ja/database_engines/index.md b/docs/ja/database_engines/index.md
new file mode 120000
index 00000000000..bbdb762a4ad
--- /dev/null
+++ b/docs/ja/database_engines/index.md
@@ -0,0 +1 @@
+../../en/database_engines/index.md
\ No newline at end of file
diff --git a/docs/ja/database_engines/lazy.md b/docs/ja/database_engines/lazy.md
new file mode 120000
index 00000000000..66830dcdb2f
--- /dev/null
+++ b/docs/ja/database_engines/lazy.md
@@ -0,0 +1 @@
+../../en/database_engines/lazy.md
\ No newline at end of file
diff --git a/docs/ja/database_engines/mysql.md b/docs/ja/database_engines/mysql.md
new file mode 120000
index 00000000000..51ac4126e2d
--- /dev/null
+++ b/docs/ja/database_engines/mysql.md
@@ -0,0 +1 @@
+../../en/database_engines/mysql.md
\ No newline at end of file
diff --git a/docs/ja/development/architecture.md b/docs/ja/development/architecture.md
new file mode 120000
index 00000000000..abda4dd48a8
--- /dev/null
+++ b/docs/ja/development/architecture.md
@@ -0,0 +1 @@
+../../en/development/architecture.md
\ No newline at end of file
diff --git a/docs/ja/development/build.md b/docs/ja/development/build.md
new file mode 120000
index 00000000000..480dbc2e9f5
--- /dev/null
+++ b/docs/ja/development/build.md
@@ -0,0 +1 @@
+../../en/development/build.md
\ No newline at end of file
diff --git a/docs/ja/development/build_cross_arm.md b/docs/ja/development/build_cross_arm.md
new file mode 120000
index 00000000000..983a9872dc1
--- /dev/null
+++ b/docs/ja/development/build_cross_arm.md
@@ -0,0 +1 @@
+../../en/development/build_cross_arm.md
\ No newline at end of file
diff --git a/docs/ja/development/build_cross_osx.md b/docs/ja/development/build_cross_osx.md
new file mode 120000
index 00000000000..72e64e8631f
--- /dev/null
+++ b/docs/ja/development/build_cross_osx.md
@@ -0,0 +1 @@
+../../en/development/build_cross_osx.md
\ No newline at end of file
diff --git a/docs/ja/development/build_osx.md b/docs/ja/development/build_osx.md
new file mode 120000
index 00000000000..f9adaf24584
--- /dev/null
+++ b/docs/ja/development/build_osx.md
@@ -0,0 +1 @@
+../../en/development/build_osx.md
\ No newline at end of file
diff --git a/docs/ja/development/contrib.md b/docs/ja/development/contrib.md
new file mode 120000
index 00000000000..4749f95f9ef
--- /dev/null
+++ b/docs/ja/development/contrib.md
@@ -0,0 +1 @@
+../../en/development/contrib.md
\ No newline at end of file
diff --git a/docs/ja/development/developer_instruction.md b/docs/ja/development/developer_instruction.md
new file mode 120000
index 00000000000..bdfa9047aa2
--- /dev/null
+++ b/docs/ja/development/developer_instruction.md
@@ -0,0 +1 @@
+../../en/development/developer_instruction.md
\ No newline at end of file
diff --git a/docs/ja/development/index.md b/docs/ja/development/index.md
new file mode 120000
index 00000000000..1e2ad97dcc5
--- /dev/null
+++ b/docs/ja/development/index.md
@@ -0,0 +1 @@
+../../en/development/index.md
\ No newline at end of file
diff --git a/docs/ja/development/style.md b/docs/ja/development/style.md
new file mode 120000
index 00000000000..c1bbf11f421
--- /dev/null
+++ b/docs/ja/development/style.md
@@ -0,0 +1 @@
+../../en/development/style.md
\ No newline at end of file
diff --git a/docs/ja/development/tests.md b/docs/ja/development/tests.md
new file mode 120000
index 00000000000..c03d36c3916
--- /dev/null
+++ b/docs/ja/development/tests.md
@@ -0,0 +1 @@
+../../en/development/tests.md
\ No newline at end of file
diff --git a/docs/ja/faq/general.md b/docs/ja/faq/general.md
new file mode 120000
index 00000000000..bc267395b1b
--- /dev/null
+++ b/docs/ja/faq/general.md
@@ -0,0 +1 @@
+../../en/faq/general.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/example_datasets/amplab_benchmark.md b/docs/ja/getting_started/example_datasets/amplab_benchmark.md
new file mode 120000
index 00000000000..78c93906bb0
--- /dev/null
+++ b/docs/ja/getting_started/example_datasets/amplab_benchmark.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/amplab_benchmark.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/example_datasets/criteo.md b/docs/ja/getting_started/example_datasets/criteo.md
new file mode 120000
index 00000000000..507dc68cd62
--- /dev/null
+++ b/docs/ja/getting_started/example_datasets/criteo.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/criteo.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/example_datasets/metrica.md b/docs/ja/getting_started/example_datasets/metrica.md
new file mode 120000
index 00000000000..984023973eb
--- /dev/null
+++ b/docs/ja/getting_started/example_datasets/metrica.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/metrica.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/example_datasets/nyc_taxi.md b/docs/ja/getting_started/example_datasets/nyc_taxi.md
new file mode 120000
index 00000000000..c47fc83a293
--- /dev/null
+++ b/docs/ja/getting_started/example_datasets/nyc_taxi.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/nyc_taxi.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/example_datasets/ontime.md b/docs/ja/getting_started/example_datasets/ontime.md
new file mode 120000
index 00000000000..87cfbb8be91
--- /dev/null
+++ b/docs/ja/getting_started/example_datasets/ontime.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/ontime.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/example_datasets/star_schema.md b/docs/ja/getting_started/example_datasets/star_schema.md
new file mode 120000
index 00000000000..1c26392dd23
--- /dev/null
+++ b/docs/ja/getting_started/example_datasets/star_schema.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/star_schema.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/example_datasets/wikistat.md b/docs/ja/getting_started/example_datasets/wikistat.md
new file mode 120000
index 00000000000..bf6e780fb27
--- /dev/null
+++ b/docs/ja/getting_started/example_datasets/wikistat.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/wikistat.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/index.md b/docs/ja/getting_started/index.md
new file mode 120000
index 00000000000..1acedb0f03e
--- /dev/null
+++ b/docs/ja/getting_started/index.md
@@ -0,0 +1 @@
+../../en/getting_started/index.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/install.md b/docs/ja/getting_started/install.md
new file mode 120000
index 00000000000..60aa3fb93a4
--- /dev/null
+++ b/docs/ja/getting_started/install.md
@@ -0,0 +1 @@
+../../en/getting_started/install.md
\ No newline at end of file
diff --git a/docs/ja/getting_started/tutorial.md b/docs/ja/getting_started/tutorial.md
new file mode 120000
index 00000000000..8bc40816ab2
--- /dev/null
+++ b/docs/ja/getting_started/tutorial.md
@@ -0,0 +1 @@
+../../en/getting_started/tutorial.md
\ No newline at end of file
diff --git a/docs/ja/guides/apply_catboost_model.md b/docs/ja/guides/apply_catboost_model.md
new file mode 120000
index 00000000000..dd36e885974
--- /dev/null
+++ b/docs/ja/guides/apply_catboost_model.md
@@ -0,0 +1 @@
+../../en/guides/apply_catboost_model.md
\ No newline at end of file
diff --git a/docs/ja/guides/index.md b/docs/ja/guides/index.md
new file mode 120000
index 00000000000..162dcbc3b8f
--- /dev/null
+++ b/docs/ja/guides/index.md
@@ -0,0 +1 @@
+../../en/guides/index.md
\ No newline at end of file
diff --git a/docs/ja/images/column_oriented.gif b/docs/ja/images/column_oriented.gif
new file mode 100644
index 00000000000..15f4b12e697
Binary files /dev/null and b/docs/ja/images/column_oriented.gif differ
diff --git a/docs/ja/images/logo.svg b/docs/ja/images/logo.svg
new file mode 100644
index 00000000000..70662da887e
--- /dev/null
+++ b/docs/ja/images/logo.svg
@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="54" height="48" viewBox="0 0 9 8">
+    <style>
+        .o{fill:#fc0}
+        .r{fill:#f00}
+    </style>
+    <path class="r" d="M0,7 h1 v1 h-1 z"/>
+    <path class="o" d="M0,0 h1 v7 h-1 z"/>
+    <path class="o" d="M2,0 h1 v8 h-1 z"/>
+    <path class="o" d="M4,0 h1 v8 h-1 z"/>
+    <path class="o" d="M6,0 h1 v8 h-1 z"/>
+    <path class="o" d="M8,3.25 h1 v1.5 h-1 z"/>
+</svg>
diff --git a/docs/ja/images/row_oriented.gif b/docs/ja/images/row_oriented.gif
new file mode 100644
index 00000000000..53daa20f322
Binary files /dev/null and b/docs/ja/images/row_oriented.gif differ
diff --git a/docs/ja/index.md b/docs/ja/index.md
deleted file mode 100644
index 6dea5f6570b..00000000000
--- a/docs/ja/index.md
+++ /dev/null
@@ -1,142 +0,0 @@
-# ClickHouseとは?
-
-ClickHouseは、クエリのオンライン分析処理（OLAP）用の列指向のデータベース管理システム（DBMS）です。
-
-「通常の」行指向のDBMSでは、データは次の順序で保存されます。
-
-| Row | WatchID | JavaEnable | Title | GoodEvent | EventTime |
-| ------ | ------------------- | ---------- | ------------------ | --------- | ------------------- |
-| #0 | 89354350662 | 1 | Investor Relations | 1 | 2016-05-18 05:19:20 |
-| #1 | 90329509958 | 0 | Contact us | 1 | 2016-05-18 08:10:20 |
-| #2 | 89953706054 | 1 | Mission | 1 | 2016-05-18 07:38:00 |
-| #N | ... | ... | ... | ... | ... |
-
-つまり、行に関連するすべての値は物理的に隣り合わせに格納されます。
-
-行指向のDBMSの例：MySQL, Postgres および MS SQL Server
-{: .grey }
-
-列指向のDBMSでは、データは次のように保存されます：
-
-| Row: | #0 | #1 | #2 | #N |
-| ----------- | ------------------- | ------------------- | ------------------- | ------------------- |
-| WatchID: | 89354350662 | 90329509958 | 89953706054 | ... |
-| JavaEnable: | 1 | 0 | 1 | ... |
-| Title: | Investor Relations | Contact us | Mission | ... |
-| GoodEvent: | 1 | 1 | 1 | ... |
-| EventTime: | 2016-05-18 05:19:20 | 2016-05-18 08:10:20 | 2016-05-18 07:38:00 | ... |
-
-これらの例は、データが配置される順序のみを示しています。
-異なる列の値は別々に保存され、同じ列のデータは一緒に保存されます。
-
-列指向DBMSの例：Vertica, Paraccel (Actian Matrix and Amazon Redshift), Sybase IQ, Exasol, Infobright, InfiniDB, MonetDB (VectorWise and Actian Vector), LucidDB, SAP HANA, Google Dremel, Google PowerDrill, Druid および kdb+
-{: .grey }
-
-異なったデータ格納の順序は、異なったシナリオにより適します。
-データアクセスシナリオとは、クエリの実行内容、頻度、割合を指します。クエリで読み取られるの各種データの量（行、列、バイト）。データの読み取りと更新の関係。作業データのサイズとローカルでの使用方法。トランザクションが使用されるかどうか、およびそれらがどの程度分離されているか。データ複製と論理的整合性の要件。クエリの種類ごとの遅延とスループットの要件など。
-
-システムの負荷が高いほど、使用シナリオの要件に一致するようにセットアップされたシステムをカスタマイズすることがより重要になり、このカスタマイズはより細かくなります。大きく異なるシナリオに等しく適したシステムはありません。システムがさまざまなシナリオに適応可能である場合、高負荷下では、システムはすべてのシナリオを同等に不十分に処理するか、1つまたはいくつかの可能なシナリオでうまく機能します。
-
-## OLAPシナリオの主要なプロパティ
-
-- リクエストの大部分は読み取りアクセス用である。
-- データは、単一行ではなく、かなり大きなバッチ（> 1000行）で更新されます。または、まったく更新されない。
-- データはDBに追加されるが、変更されない。
-- 読み取りの場合、非常に多くの行がDBから抽出されるが、一部の列のみ。
-- テーブルは「幅が広く」、多数の列が含まれる。
-- クエリは比較的まれ（通常、サーバーあたり毎秒数百あるいはそれ以下の数のクエリ）。
-- 単純なクエリでは、約50ミリ秒の遅延が容認される。
-- 列の値はかなり小さく、数値や短い文字列（たとえば、URLごとに60バイト）。
-- 単一のクエリを処理する場合、高いスループットが必要（サーバーあたり毎秒最大数十億行）。
-- トランザクションは必要ない。
-- データの一貫性の要件が低い。
-- クエリごとに1つの大きなテーブルがある。 1つを除くすべてのテーブルは小さい。
-- クエリ結果は、ソースデータよりも大幅に小さくなる。つまり、データはフィルター処理または集計されるため、結果は単一サーバーのRAMに収まる。
-
-OLAPシナリオは、他の一般的なシナリオ（OLTPやKey-Valueアクセスなど）とは非常に異なることが容易にわかります。 したがって、まともなパフォーマンスを得るには、OLTPまたはKey-Value DBを使用して分析クエリを処理しようとするのは無意味です。 たとえば、分析にMongoDBまたはRedisを使用しようとすると、OLAPデータベースに比べてパフォーマンスが非常に低下します。
-
-## OLAPシナリオで列指向データベースがよりよく機能する理由
-
-列指向データベースは、OLAPシナリオにより適しています。ほとんどのクエリの処理が少なくとも100倍高速です。 理由を以下に詳しく説明しますが、その根拠は視覚的に簡単に説明できます：
-
-**行指向DBMS**
-
-![Row-oriented](images/row_oriented.gif#)
-
-**列指向DBMS**
-
-![Column-oriented](images/column_oriented.gif#)
-
-違いがわかりましたか？
-
-### Input/output
-
-1. 分析クエリでは、少数のテーブル列のみを読み取る必要があります。列指向のデータベースでは、必要なデータのみを読み取ることができます。たとえば、100のうち5つの列が必要な場合、I/Oが20倍削減されることが期待できます。
-2. データはパケットで読み取られるため、圧縮が容易です。列のデータも圧縮が簡単です。これにより、I/Oボリュームがさらに削減されます。
-3. I/Oの削減により、より多くのデータがシステムキャッシュに収まります。
-
-たとえば、「各広告プラットフォームのレコード数をカウントする」クエリでは、1つの「広告プラットフォームID」列を読み取る必要がありますが、これは非圧縮では1バイトの領域を要します。トラフィックのほとんどが広告プラットフォームからのものではない場合、この列は少なくとも10倍の圧縮が期待できます。高速な圧縮アルゴリズムを使用すれば、1秒あたり少なくとも非圧縮データに換算して数ギガバイトの速度でデータを展開できます。つまり、このクエリは、単一のサーバーで1秒あたり約数十億行の速度で処理できます。この速度はまさに実際に達成されます。
-
-<details markdown="1"><summary>Example</summary>
-```
-$ clickhouse-client
-ClickHouse client version 0.0.52053.
-Connecting to localhost:9000.
-Connected to ClickHouse server version 0.0.52053.
-
-:) SELECT CounterID, count() FROM hits GROUP BY CounterID ORDER BY count() DESC LIMIT 20
-
-SELECT
-CounterID,
-count()
-FROM hits
-GROUP BY CounterID
-ORDER BY count() DESC
-LIMIT 20
-
-┌─CounterID─┬──count()─┐
-│    114208 │ 56057344 │
-│    115080 │ 51619590 │
-│      3228 │ 44658301 │
-│     38230 │ 42045932 │
-│    145263 │ 42042158 │
-│     91244 │ 38297270 │
-│    154139 │ 26647572 │
-│    150748 │ 24112755 │
-│    242232 │ 21302571 │
-│    338158 │ 13507087 │
-│     62180 │ 12229491 │
-│     82264 │ 12187441 │
-│    232261 │ 12148031 │
-│    146272 │ 11438516 │
-│    168777 │ 11403636 │
-│   4120072 │ 11227824 │
-│  10938808 │ 10519739 │
-│     74088 │  9047015 │
-│    115079 │  8837972 │
-│    337234 │  8205961 │
-└───────────┴──────────┘
-
-20 rows in set. Elapsed: 0.153 sec. Processed 1.00 billion rows, 4.00 GB (6.53 billion rows/s., 26.10 GB/s.)
-
-:)
-```
-
-</details>
-
-### CPU
-
-クエリを実行するには大量の行を処理する必要があるため、個別の行ではなくベクター全体のすべての操作をディスパッチするか、ディスパッチコストがほとんどないようにクエリエンジンを実装すると効率的です。 適切なディスクサブシステムでこれを行わないと、クエリインタープリターが必然的にCPUを失速させます。
-データを列に格納し、可能な場合は列ごとに処理することは理にかなっています。
-
-これを行うには2つの方法があります:
-
-1. ベクトルエンジン。 すべての操作は、個別の値ではなく、ベクトルに対して記述されます。 これは、オペレーションを頻繁に呼び出す必要がなく、ディスパッチコストが無視できることを意味します。 操作コードには、最適化された内部サイクルが含まれています。
-
-2. コード生成。 クエリ用に生成されたコードには、すべての間接的な呼び出しが含まれています。
-
-これは、単純なクエリを実行する場合には意味がないため、「通常の」データベースでは実行されません。 ただし、例外があります。 たとえば、MemSQLはコード生成を使用して、SQLクエリを処理する際の遅延を減らします。 （比較のために、分析DBMSではレイテンシではなくスループットの最適化が必要です。）
-
-CPU効率のために、クエリ言語は宣言型（SQLまたはMDX）、または少なくともベクトル（J、K）でなければなりません。 クエリには、最適化を可能にする暗黙的なループのみを含める必要があります。
-
-[Original article](https://clickhouse.yandex/docs/en/) <!--hide-->
diff --git a/docs/ja/index.md b/docs/ja/index.md
new file mode 120000
index 00000000000..facf2d71348
--- /dev/null
+++ b/docs/ja/index.md
@@ -0,0 +1 @@
+../en/index.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/cli.md b/docs/ja/interfaces/cli.md
new file mode 120000
index 00000000000..04588066828
--- /dev/null
+++ b/docs/ja/interfaces/cli.md
@@ -0,0 +1 @@
+../../en/interfaces/cli.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/cpp.md b/docs/ja/interfaces/cpp.md
new file mode 120000
index 00000000000..581e50e774d
--- /dev/null
+++ b/docs/ja/interfaces/cpp.md
@@ -0,0 +1 @@
+../../en/interfaces/cpp.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/formats.md b/docs/ja/interfaces/formats.md
new file mode 120000
index 00000000000..41a65ebe579
--- /dev/null
+++ b/docs/ja/interfaces/formats.md
@@ -0,0 +1 @@
+../../en/interfaces/formats.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/http.md b/docs/ja/interfaces/http.md
new file mode 120000
index 00000000000..fb293841d8b
--- /dev/null
+++ b/docs/ja/interfaces/http.md
@@ -0,0 +1 @@
+../../en/interfaces/http.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/index.md b/docs/ja/interfaces/index.md
new file mode 120000
index 00000000000..61537763cac
--- /dev/null
+++ b/docs/ja/interfaces/index.md
@@ -0,0 +1 @@
+../../en/interfaces/index.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/jdbc.md b/docs/ja/interfaces/jdbc.md
new file mode 120000
index 00000000000..27dfe0cfa5a
--- /dev/null
+++ b/docs/ja/interfaces/jdbc.md
@@ -0,0 +1 @@
+../../en/interfaces/jdbc.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/odbc.md b/docs/ja/interfaces/odbc.md
new file mode 120000
index 00000000000..5ff7610e061
--- /dev/null
+++ b/docs/ja/interfaces/odbc.md
@@ -0,0 +1 @@
+../../en/interfaces/odbc.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/tcp.md b/docs/ja/interfaces/tcp.md
new file mode 120000
index 00000000000..a0529a856e4
--- /dev/null
+++ b/docs/ja/interfaces/tcp.md
@@ -0,0 +1 @@
+../../en/interfaces/tcp.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/third-party/client_libraries.md b/docs/ja/interfaces/third-party/client_libraries.md
new file mode 120000
index 00000000000..5320bbe1e16
--- /dev/null
+++ b/docs/ja/interfaces/third-party/client_libraries.md
@@ -0,0 +1 @@
+../../../en/interfaces/third-party/client_libraries.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/third-party/gui.md b/docs/ja/interfaces/third-party/gui.md
new file mode 120000
index 00000000000..ef7bc904197
--- /dev/null
+++ b/docs/ja/interfaces/third-party/gui.md
@@ -0,0 +1 @@
+../../../en/interfaces/third-party/gui.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/third-party/integrations.md b/docs/ja/interfaces/third-party/integrations.md
new file mode 120000
index 00000000000..9cd0a21e676
--- /dev/null
+++ b/docs/ja/interfaces/third-party/integrations.md
@@ -0,0 +1 @@
+../../../en/interfaces/third-party/integrations.md
\ No newline at end of file
diff --git a/docs/ja/interfaces/third-party/proxy.md b/docs/ja/interfaces/third-party/proxy.md
new file mode 120000
index 00000000000..877f1b51dab
--- /dev/null
+++ b/docs/ja/interfaces/third-party/proxy.md
@@ -0,0 +1 @@
+../../../en/interfaces/third-party/proxy.md
\ No newline at end of file
diff --git a/docs/ja/introduction/distinctive_features.md b/docs/ja/introduction/distinctive_features.md
new file mode 120000
index 00000000000..9cf00a2a00f
--- /dev/null
+++ b/docs/ja/introduction/distinctive_features.md
@@ -0,0 +1 @@
+../../en/introduction/distinctive_features.md
\ No newline at end of file
diff --git a/docs/ja/introduction/features_considered_disadvantages.md b/docs/ja/introduction/features_considered_disadvantages.md
new file mode 120000
index 00000000000..45d3cdf563a
--- /dev/null
+++ b/docs/ja/introduction/features_considered_disadvantages.md
@@ -0,0 +1 @@
+../../en/introduction/features_considered_disadvantages.md
\ No newline at end of file
diff --git a/docs/ja/introduction/history.md b/docs/ja/introduction/history.md
new file mode 120000
index 00000000000..7004e990a59
--- /dev/null
+++ b/docs/ja/introduction/history.md
@@ -0,0 +1 @@
+../../en/introduction/history.md
\ No newline at end of file
diff --git a/docs/ja/introduction/performance.md b/docs/ja/introduction/performance.md
new file mode 120000
index 00000000000..cb2912bcb81
--- /dev/null
+++ b/docs/ja/introduction/performance.md
@@ -0,0 +1 @@
+../../en/introduction/performance.md
\ No newline at end of file
diff --git a/docs/ja/operations/access_rights.md b/docs/ja/operations/access_rights.md
new file mode 120000
index 00000000000..73463029569
--- /dev/null
+++ b/docs/ja/operations/access_rights.md
@@ -0,0 +1 @@
+../../en/operations/access_rights.md
\ No newline at end of file
diff --git a/docs/ja/operations/backup.md b/docs/ja/operations/backup.md
new file mode 120000
index 00000000000..1003fb30e61
--- /dev/null
+++ b/docs/ja/operations/backup.md
@@ -0,0 +1 @@
+../../en/operations/backup.md
\ No newline at end of file
diff --git a/docs/ja/operations/configuration_files.md b/docs/ja/operations/configuration_files.md
new file mode 120000
index 00000000000..a2d73dbaa25
--- /dev/null
+++ b/docs/ja/operations/configuration_files.md
@@ -0,0 +1 @@
+../../en/operations/configuration_files.md
\ No newline at end of file
diff --git a/docs/ja/operations/index.md b/docs/ja/operations/index.md
new file mode 120000
index 00000000000..ce854687b86
--- /dev/null
+++ b/docs/ja/operations/index.md
@@ -0,0 +1 @@
+../../en/operations/index.md
\ No newline at end of file
diff --git a/docs/ja/operations/monitoring.md b/docs/ja/operations/monitoring.md
new file mode 120000
index 00000000000..515ae8b4fff
--- /dev/null
+++ b/docs/ja/operations/monitoring.md
@@ -0,0 +1 @@
+../../en/operations/monitoring.md
\ No newline at end of file
diff --git a/docs/ja/operations/quotas.md b/docs/ja/operations/quotas.md
new file mode 120000
index 00000000000..1c52cdf1e91
--- /dev/null
+++ b/docs/ja/operations/quotas.md
@@ -0,0 +1 @@
+../../en/operations/quotas.md
\ No newline at end of file
diff --git a/docs/ja/operations/requirements.md b/docs/ja/operations/requirements.md
new file mode 120000
index 00000000000..a71283af25c
--- /dev/null
+++ b/docs/ja/operations/requirements.md
@@ -0,0 +1 @@
+../../en/operations/requirements.md
\ No newline at end of file
diff --git a/docs/ja/operations/server_settings/index.md b/docs/ja/operations/server_settings/index.md
new file mode 120000
index 00000000000..1d1a0585a42
--- /dev/null
+++ b/docs/ja/operations/server_settings/index.md
@@ -0,0 +1 @@
+../../../en/operations/server_settings/index.md
\ No newline at end of file
diff --git a/docs/ja/operations/server_settings/settings.md b/docs/ja/operations/server_settings/settings.md
new file mode 120000
index 00000000000..19cd2e82ce7
--- /dev/null
+++ b/docs/ja/operations/server_settings/settings.md
@@ -0,0 +1 @@
+../../../en/operations/server_settings/settings.md
\ No newline at end of file
diff --git a/docs/ja/operations/settings/constraints_on_settings.md b/docs/ja/operations/settings/constraints_on_settings.md
new file mode 120000
index 00000000000..4dacf908662
--- /dev/null
+++ b/docs/ja/operations/settings/constraints_on_settings.md
@@ -0,0 +1 @@
+../../../en/operations/settings/constraints_on_settings.md
\ No newline at end of file
diff --git a/docs/ja/operations/settings/index.md b/docs/ja/operations/settings/index.md
new file mode 120000
index 00000000000..fc3968d1f1e
--- /dev/null
+++ b/docs/ja/operations/settings/index.md
@@ -0,0 +1 @@
+../../../en/operations/settings/index.md
\ No newline at end of file
diff --git a/docs/ja/operations/settings/permissions_for_queries.md b/docs/ja/operations/settings/permissions_for_queries.md
new file mode 120000
index 00000000000..ce8473bf01c
--- /dev/null
+++ b/docs/ja/operations/settings/permissions_for_queries.md
@@ -0,0 +1 @@
+../../../en/operations/settings/permissions_for_queries.md
\ No newline at end of file
diff --git a/docs/ja/operations/settings/query_complexity.md b/docs/ja/operations/settings/query_complexity.md
new file mode 120000
index 00000000000..9a9c6d975a9
--- /dev/null
+++ b/docs/ja/operations/settings/query_complexity.md
@@ -0,0 +1 @@
+../../../en/operations/settings/query_complexity.md
\ No newline at end of file
diff --git a/docs/ja/operations/settings/settings.md b/docs/ja/operations/settings/settings.md
new file mode 120000
index 00000000000..0c8df3cfc90
--- /dev/null
+++ b/docs/ja/operations/settings/settings.md
@@ -0,0 +1 @@
+../../../en/operations/settings/settings.md
\ No newline at end of file
diff --git a/docs/ja/operations/settings/settings_profiles.md b/docs/ja/operations/settings/settings_profiles.md
new file mode 120000
index 00000000000..35d9747ad56
--- /dev/null
+++ b/docs/ja/operations/settings/settings_profiles.md
@@ -0,0 +1 @@
+../../../en/operations/settings/settings_profiles.md
\ No newline at end of file
diff --git a/docs/ja/operations/settings/settings_users.md b/docs/ja/operations/settings/settings_users.md
new file mode 120000
index 00000000000..3a6a7cf6948
--- /dev/null
+++ b/docs/ja/operations/settings/settings_users.md
@@ -0,0 +1 @@
+../../../en/operations/settings/settings_users.md
\ No newline at end of file
diff --git a/docs/ja/operations/system_tables.md b/docs/ja/operations/system_tables.md
new file mode 120000
index 00000000000..c5701190dca
--- /dev/null
+++ b/docs/ja/operations/system_tables.md
@@ -0,0 +1 @@
+../../en/operations/system_tables.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/aggregatingmergetree.md b/docs/ja/operations/table_engines/aggregatingmergetree.md
new file mode 120000
index 00000000000..907a073e0c8
--- /dev/null
+++ b/docs/ja/operations/table_engines/aggregatingmergetree.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/aggregatingmergetree.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/buffer.md b/docs/ja/operations/table_engines/buffer.md
new file mode 120000
index 00000000000..0a3c372fa67
--- /dev/null
+++ b/docs/ja/operations/table_engines/buffer.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/buffer.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/collapsingmergetree.md b/docs/ja/operations/table_engines/collapsingmergetree.md
new file mode 120000
index 00000000000..ef5cebb48d8
--- /dev/null
+++ b/docs/ja/operations/table_engines/collapsingmergetree.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/collapsingmergetree.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/custom_partitioning_key.md b/docs/ja/operations/table_engines/custom_partitioning_key.md
new file mode 120000
index 00000000000..a9d18cacb25
--- /dev/null
+++ b/docs/ja/operations/table_engines/custom_partitioning_key.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/custom_partitioning_key.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/dictionary.md b/docs/ja/operations/table_engines/dictionary.md
new file mode 120000
index 00000000000..2a95f4a669b
--- /dev/null
+++ b/docs/ja/operations/table_engines/dictionary.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/dictionary.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/distributed.md b/docs/ja/operations/table_engines/distributed.md
new file mode 120000
index 00000000000..46994303c35
--- /dev/null
+++ b/docs/ja/operations/table_engines/distributed.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/distributed.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/external_data.md b/docs/ja/operations/table_engines/external_data.md
new file mode 120000
index 00000000000..27a7b6acec2
--- /dev/null
+++ b/docs/ja/operations/table_engines/external_data.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/external_data.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/file.md b/docs/ja/operations/table_engines/file.md
new file mode 120000
index 00000000000..27dffc8d78f
--- /dev/null
+++ b/docs/ja/operations/table_engines/file.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/file.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/graphitemergetree.md b/docs/ja/operations/table_engines/graphitemergetree.md
new file mode 120000
index 00000000000..654425d050a
--- /dev/null
+++ b/docs/ja/operations/table_engines/graphitemergetree.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/graphitemergetree.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/hdfs.md b/docs/ja/operations/table_engines/hdfs.md
new file mode 120000
index 00000000000..d4dbfa46e68
--- /dev/null
+++ b/docs/ja/operations/table_engines/hdfs.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/hdfs.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/index.md b/docs/ja/operations/table_engines/index.md
new file mode 120000
index 00000000000..994dff9b516
--- /dev/null
+++ b/docs/ja/operations/table_engines/index.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/index.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/jdbc.md b/docs/ja/operations/table_engines/jdbc.md
new file mode 120000
index 00000000000..5165d704b9a
--- /dev/null
+++ b/docs/ja/operations/table_engines/jdbc.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/jdbc.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/join.md b/docs/ja/operations/table_engines/join.md
new file mode 120000
index 00000000000..0914ab950ed
--- /dev/null
+++ b/docs/ja/operations/table_engines/join.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/join.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/kafka.md b/docs/ja/operations/table_engines/kafka.md
new file mode 120000
index 00000000000..cb7bd5dd0f8
--- /dev/null
+++ b/docs/ja/operations/table_engines/kafka.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/kafka.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/log.md b/docs/ja/operations/table_engines/log.md
new file mode 120000
index 00000000000..2c39ba68522
--- /dev/null
+++ b/docs/ja/operations/table_engines/log.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/log.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/log_family.md b/docs/ja/operations/table_engines/log_family.md
new file mode 120000
index 00000000000..8c5b5f0365b
--- /dev/null
+++ b/docs/ja/operations/table_engines/log_family.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/log_family.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/materializedview.md b/docs/ja/operations/table_engines/materializedview.md
new file mode 120000
index 00000000000..e3b5deb73dc
--- /dev/null
+++ b/docs/ja/operations/table_engines/materializedview.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/materializedview.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/memory.md b/docs/ja/operations/table_engines/memory.md
new file mode 120000
index 00000000000..eee940c7bd3
--- /dev/null
+++ b/docs/ja/operations/table_engines/memory.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/memory.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/merge.md b/docs/ja/operations/table_engines/merge.md
new file mode 120000
index 00000000000..9e17d9bb939
--- /dev/null
+++ b/docs/ja/operations/table_engines/merge.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/merge.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/mergetree.md b/docs/ja/operations/table_engines/mergetree.md
new file mode 120000
index 00000000000..cc6ac1e5297
--- /dev/null
+++ b/docs/ja/operations/table_engines/mergetree.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/mergetree.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/mysql.md b/docs/ja/operations/table_engines/mysql.md
new file mode 120000
index 00000000000..e4c268658cf
--- /dev/null
+++ b/docs/ja/operations/table_engines/mysql.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/mysql.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/null.md b/docs/ja/operations/table_engines/null.md
new file mode 120000
index 00000000000..c7d9264571e
--- /dev/null
+++ b/docs/ja/operations/table_engines/null.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/null.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/odbc.md b/docs/ja/operations/table_engines/odbc.md
new file mode 120000
index 00000000000..06091fd5377
--- /dev/null
+++ b/docs/ja/operations/table_engines/odbc.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/odbc.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/replacingmergetree.md b/docs/ja/operations/table_engines/replacingmergetree.md
new file mode 120000
index 00000000000..63ff25a4dd6
--- /dev/null
+++ b/docs/ja/operations/table_engines/replacingmergetree.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/replacingmergetree.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/replication.md b/docs/ja/operations/table_engines/replication.md
new file mode 120000
index 00000000000..b4b22ac708b
--- /dev/null
+++ b/docs/ja/operations/table_engines/replication.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/replication.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/set.md b/docs/ja/operations/table_engines/set.md
new file mode 120000
index 00000000000..d37e659badd
--- /dev/null
+++ b/docs/ja/operations/table_engines/set.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/set.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/stripelog.md b/docs/ja/operations/table_engines/stripelog.md
new file mode 120000
index 00000000000..f6521a41e3e
--- /dev/null
+++ b/docs/ja/operations/table_engines/stripelog.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/stripelog.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/summingmergetree.md b/docs/ja/operations/table_engines/summingmergetree.md
new file mode 120000
index 00000000000..2b67e953d8a
--- /dev/null
+++ b/docs/ja/operations/table_engines/summingmergetree.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/summingmergetree.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/tinylog.md b/docs/ja/operations/table_engines/tinylog.md
new file mode 120000
index 00000000000..bda90c7d5ce
--- /dev/null
+++ b/docs/ja/operations/table_engines/tinylog.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/tinylog.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/url.md b/docs/ja/operations/table_engines/url.md
new file mode 120000
index 00000000000..d0de71dcf40
--- /dev/null
+++ b/docs/ja/operations/table_engines/url.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/url.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/versionedcollapsingmergetree.md b/docs/ja/operations/table_engines/versionedcollapsingmergetree.md
new file mode 120000
index 00000000000..5843fba70b8
--- /dev/null
+++ b/docs/ja/operations/table_engines/versionedcollapsingmergetree.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/versionedcollapsingmergetree.md
\ No newline at end of file
diff --git a/docs/ja/operations/table_engines/view.md b/docs/ja/operations/table_engines/view.md
new file mode 120000
index 00000000000..3f2164181a7
--- /dev/null
+++ b/docs/ja/operations/table_engines/view.md
@@ -0,0 +1 @@
+../../../en/operations/table_engines/view.md
\ No newline at end of file
diff --git a/docs/ja/operations/tips.md b/docs/ja/operations/tips.md
new file mode 120000
index 00000000000..9b3413bdbc3
--- /dev/null
+++ b/docs/ja/operations/tips.md
@@ -0,0 +1 @@
+../../en/operations/tips.md
\ No newline at end of file
diff --git a/docs/ja/operations/troubleshooting.md b/docs/ja/operations/troubleshooting.md
new file mode 120000
index 00000000000..84f0ff34f41
--- /dev/null
+++ b/docs/ja/operations/troubleshooting.md
@@ -0,0 +1 @@
+../../en/operations/troubleshooting.md
\ No newline at end of file
diff --git a/docs/ja/operations/update.md b/docs/ja/operations/update.md
new file mode 120000
index 00000000000..88a092c0dff
--- /dev/null
+++ b/docs/ja/operations/update.md
@@ -0,0 +1 @@
+../../en/operations/update.md
\ No newline at end of file
diff --git a/docs/ja/operations/utils/clickhouse-copier.md b/docs/ja/operations/utils/clickhouse-copier.md
new file mode 120000
index 00000000000..c9e89e33c7b
--- /dev/null
+++ b/docs/ja/operations/utils/clickhouse-copier.md
@@ -0,0 +1 @@
+../../../en/operations/utils/clickhouse-copier.md
\ No newline at end of file
diff --git a/docs/ja/operations/utils/clickhouse-local.md b/docs/ja/operations/utils/clickhouse-local.md
new file mode 120000
index 00000000000..032aaaa2b84
--- /dev/null
+++ b/docs/ja/operations/utils/clickhouse-local.md
@@ -0,0 +1 @@
+../../../en/operations/utils/clickhouse-local.md
\ No newline at end of file
diff --git a/docs/ja/operations/utils/index.md b/docs/ja/operations/utils/index.md
new file mode 120000
index 00000000000..dd089d1ef4b
--- /dev/null
+++ b/docs/ja/operations/utils/index.md
@@ -0,0 +1 @@
+../../../en/operations/utils/index.md
\ No newline at end of file
diff --git a/docs/ja/query_language/agg_functions/combinators.md b/docs/ja/query_language/agg_functions/combinators.md
new file mode 120000
index 00000000000..2b914cebd15
--- /dev/null
+++ b/docs/ja/query_language/agg_functions/combinators.md
@@ -0,0 +1 @@
+../../../en/query_language/agg_functions/combinators.md
\ No newline at end of file
diff --git a/docs/ja/query_language/agg_functions/index.md b/docs/ja/query_language/agg_functions/index.md
new file mode 120000
index 00000000000..2fcf67abdeb
--- /dev/null
+++ b/docs/ja/query_language/agg_functions/index.md
@@ -0,0 +1 @@
+../../../en/query_language/agg_functions/index.md
\ No newline at end of file
diff --git a/docs/ja/query_language/agg_functions/parametric_functions.md b/docs/ja/query_language/agg_functions/parametric_functions.md
new file mode 120000
index 00000000000..fd3ffafcc5b
--- /dev/null
+++ b/docs/ja/query_language/agg_functions/parametric_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/agg_functions/parametric_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/agg_functions/reference.md b/docs/ja/query_language/agg_functions/reference.md
new file mode 120000
index 00000000000..c5651cb0793
--- /dev/null
+++ b/docs/ja/query_language/agg_functions/reference.md
@@ -0,0 +1 @@
+../../../en/query_language/agg_functions/reference.md
\ No newline at end of file
diff --git a/docs/ja/query_language/alter.md b/docs/ja/query_language/alter.md
new file mode 120000
index 00000000000..44f4ecf9737
--- /dev/null
+++ b/docs/ja/query_language/alter.md
@@ -0,0 +1 @@
+../../en/query_language/alter.md
\ No newline at end of file
diff --git a/docs/ja/query_language/create.md b/docs/ja/query_language/create.md
new file mode 120000
index 00000000000..a13304d176e
--- /dev/null
+++ b/docs/ja/query_language/create.md
@@ -0,0 +1 @@
+../../en/query_language/create.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/external_dicts.md b/docs/ja/query_language/dicts/external_dicts.md
new file mode 120000
index 00000000000..491b94bffe6
--- /dev/null
+++ b/docs/ja/query_language/dicts/external_dicts.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/external_dicts.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/external_dicts_dict.md b/docs/ja/query_language/dicts/external_dicts_dict.md
new file mode 120000
index 00000000000..e27820fee60
--- /dev/null
+++ b/docs/ja/query_language/dicts/external_dicts_dict.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/external_dicts_dict.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/external_dicts_dict_layout.md b/docs/ja/query_language/dicts/external_dicts_dict_layout.md
new file mode 120000
index 00000000000..e391c5be723
--- /dev/null
+++ b/docs/ja/query_language/dicts/external_dicts_dict_layout.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/external_dicts_dict_layout.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/external_dicts_dict_lifetime.md b/docs/ja/query_language/dicts/external_dicts_dict_lifetime.md
new file mode 120000
index 00000000000..03b53c09077
--- /dev/null
+++ b/docs/ja/query_language/dicts/external_dicts_dict_lifetime.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/external_dicts_dict_lifetime.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/external_dicts_dict_sources.md b/docs/ja/query_language/dicts/external_dicts_dict_sources.md
new file mode 120000
index 00000000000..d4f4bf8ef3e
--- /dev/null
+++ b/docs/ja/query_language/dicts/external_dicts_dict_sources.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/external_dicts_dict_sources.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/external_dicts_dict_structure.md b/docs/ja/query_language/dicts/external_dicts_dict_structure.md
new file mode 120000
index 00000000000..69ff759caea
--- /dev/null
+++ b/docs/ja/query_language/dicts/external_dicts_dict_structure.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/external_dicts_dict_structure.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/index.md b/docs/ja/query_language/dicts/index.md
new file mode 120000
index 00000000000..fdc188ca2a2
--- /dev/null
+++ b/docs/ja/query_language/dicts/index.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/index.md
\ No newline at end of file
diff --git a/docs/ja/query_language/dicts/internal_dicts.md b/docs/ja/query_language/dicts/internal_dicts.md
new file mode 120000
index 00000000000..3f9408dcd45
--- /dev/null
+++ b/docs/ja/query_language/dicts/internal_dicts.md
@@ -0,0 +1 @@
+../../../en/query_language/dicts/internal_dicts.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/arithmetic_functions.md b/docs/ja/query_language/functions/arithmetic_functions.md
new file mode 120000
index 00000000000..c22acb8c7f5
--- /dev/null
+++ b/docs/ja/query_language/functions/arithmetic_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/arithmetic_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/array_functions.md b/docs/ja/query_language/functions/array_functions.md
new file mode 120000
index 00000000000..268b2295a97
--- /dev/null
+++ b/docs/ja/query_language/functions/array_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/array_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/array_join.md b/docs/ja/query_language/functions/array_join.md
new file mode 120000
index 00000000000..b100dac784d
--- /dev/null
+++ b/docs/ja/query_language/functions/array_join.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/array_join.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/bit_functions.md b/docs/ja/query_language/functions/bit_functions.md
new file mode 120000
index 00000000000..b5cccd0c56c
--- /dev/null
+++ b/docs/ja/query_language/functions/bit_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/bit_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/bitmap_functions.md b/docs/ja/query_language/functions/bitmap_functions.md
new file mode 120000
index 00000000000..0a31d3d71d8
--- /dev/null
+++ b/docs/ja/query_language/functions/bitmap_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/bitmap_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/comparison_functions.md b/docs/ja/query_language/functions/comparison_functions.md
new file mode 120000
index 00000000000..417c589867c
--- /dev/null
+++ b/docs/ja/query_language/functions/comparison_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/comparison_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/conditional_functions.md b/docs/ja/query_language/functions/conditional_functions.md
new file mode 120000
index 00000000000..ad0d775dbb5
--- /dev/null
+++ b/docs/ja/query_language/functions/conditional_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/conditional_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/date_time_functions.md b/docs/ja/query_language/functions/date_time_functions.md
new file mode 120000
index 00000000000..d11b9b8bb6b
--- /dev/null
+++ b/docs/ja/query_language/functions/date_time_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/date_time_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/encoding_functions.md b/docs/ja/query_language/functions/encoding_functions.md
new file mode 120000
index 00000000000..b2e6be1405b
--- /dev/null
+++ b/docs/ja/query_language/functions/encoding_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/encoding_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/ext_dict_functions.md b/docs/ja/query_language/functions/ext_dict_functions.md
new file mode 120000
index 00000000000..6318f900e4b
--- /dev/null
+++ b/docs/ja/query_language/functions/ext_dict_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/ext_dict_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/functions_for_nulls.md b/docs/ja/query_language/functions/functions_for_nulls.md
new file mode 120000
index 00000000000..fa57e10ad15
--- /dev/null
+++ b/docs/ja/query_language/functions/functions_for_nulls.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/functions_for_nulls.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/geo.md b/docs/ja/query_language/functions/geo.md
new file mode 120000
index 00000000000..86fa3a85d34
--- /dev/null
+++ b/docs/ja/query_language/functions/geo.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/geo.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/hash_functions.md b/docs/ja/query_language/functions/hash_functions.md
new file mode 120000
index 00000000000..90de8ba97e7
--- /dev/null
+++ b/docs/ja/query_language/functions/hash_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/hash_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/higher_order_functions.md b/docs/ja/query_language/functions/higher_order_functions.md
new file mode 120000
index 00000000000..077feba2a3e
--- /dev/null
+++ b/docs/ja/query_language/functions/higher_order_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/higher_order_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/in_functions.md b/docs/ja/query_language/functions/in_functions.md
new file mode 120000
index 00000000000..3ae5f24dbca
--- /dev/null
+++ b/docs/ja/query_language/functions/in_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/in_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/index.md b/docs/ja/query_language/functions/index.md
new file mode 120000
index 00000000000..a4e9d619cc0
--- /dev/null
+++ b/docs/ja/query_language/functions/index.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/index.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/ip_address_functions.md b/docs/ja/query_language/functions/ip_address_functions.md
new file mode 120000
index 00000000000..b58175a7cdf
--- /dev/null
+++ b/docs/ja/query_language/functions/ip_address_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/ip_address_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/json_functions.md b/docs/ja/query_language/functions/json_functions.md
new file mode 120000
index 00000000000..1b37184e006
--- /dev/null
+++ b/docs/ja/query_language/functions/json_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/json_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/logical_functions.md b/docs/ja/query_language/functions/logical_functions.md
new file mode 120000
index 00000000000..32015440e09
--- /dev/null
+++ b/docs/ja/query_language/functions/logical_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/logical_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/machine_learning_functions.md b/docs/ja/query_language/functions/machine_learning_functions.md
new file mode 120000
index 00000000000..4509602717e
--- /dev/null
+++ b/docs/ja/query_language/functions/machine_learning_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/machine_learning_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/math_functions.md b/docs/ja/query_language/functions/math_functions.md
new file mode 120000
index 00000000000..e01674eca4d
--- /dev/null
+++ b/docs/ja/query_language/functions/math_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/math_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/other_functions.md b/docs/ja/query_language/functions/other_functions.md
new file mode 120000
index 00000000000..65164784ced
--- /dev/null
+++ b/docs/ja/query_language/functions/other_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/other_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/random_functions.md b/docs/ja/query_language/functions/random_functions.md
new file mode 120000
index 00000000000..b873e0c86ac
--- /dev/null
+++ b/docs/ja/query_language/functions/random_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/random_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/rounding_functions.md b/docs/ja/query_language/functions/rounding_functions.md
new file mode 120000
index 00000000000..e1217e3b25a
--- /dev/null
+++ b/docs/ja/query_language/functions/rounding_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/rounding_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/splitting_merging_functions.md b/docs/ja/query_language/functions/splitting_merging_functions.md
new file mode 120000
index 00000000000..5f8771abdec
--- /dev/null
+++ b/docs/ja/query_language/functions/splitting_merging_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/splitting_merging_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/string_functions.md b/docs/ja/query_language/functions/string_functions.md
new file mode 120000
index 00000000000..cc4104aaf53
--- /dev/null
+++ b/docs/ja/query_language/functions/string_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/string_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/string_replace_functions.md b/docs/ja/query_language/functions/string_replace_functions.md
new file mode 120000
index 00000000000..4ec963ffd0f
--- /dev/null
+++ b/docs/ja/query_language/functions/string_replace_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/string_replace_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/string_search_functions.md b/docs/ja/query_language/functions/string_search_functions.md
new file mode 120000
index 00000000000..0a2c7f4c4f1
--- /dev/null
+++ b/docs/ja/query_language/functions/string_search_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/string_search_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/type_conversion_functions.md b/docs/ja/query_language/functions/type_conversion_functions.md
new file mode 120000
index 00000000000..fcf51570d15
--- /dev/null
+++ b/docs/ja/query_language/functions/type_conversion_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/type_conversion_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/url_functions.md b/docs/ja/query_language/functions/url_functions.md
new file mode 120000
index 00000000000..529e4ffdd53
--- /dev/null
+++ b/docs/ja/query_language/functions/url_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/url_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/uuid_functions.md b/docs/ja/query_language/functions/uuid_functions.md
new file mode 120000
index 00000000000..95e3ded0477
--- /dev/null
+++ b/docs/ja/query_language/functions/uuid_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/uuid_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/functions/ym_dict_functions.md b/docs/ja/query_language/functions/ym_dict_functions.md
new file mode 120000
index 00000000000..ec5ddc84479
--- /dev/null
+++ b/docs/ja/query_language/functions/ym_dict_functions.md
@@ -0,0 +1 @@
+../../../en/query_language/functions/ym_dict_functions.md
\ No newline at end of file
diff --git a/docs/ja/query_language/index.md b/docs/ja/query_language/index.md
new file mode 120000
index 00000000000..44dfff9bb18
--- /dev/null
+++ b/docs/ja/query_language/index.md
@@ -0,0 +1 @@
+../../en/query_language/index.md
\ No newline at end of file
diff --git a/docs/ja/query_language/insert_into.md b/docs/ja/query_language/insert_into.md
new file mode 120000
index 00000000000..29b47662b0d
--- /dev/null
+++ b/docs/ja/query_language/insert_into.md
@@ -0,0 +1 @@
+../../en/query_language/insert_into.md
\ No newline at end of file
diff --git a/docs/ja/query_language/misc.md b/docs/ja/query_language/misc.md
new file mode 120000
index 00000000000..3bd814f3568
--- /dev/null
+++ b/docs/ja/query_language/misc.md
@@ -0,0 +1 @@
+../../en/query_language/misc.md
\ No newline at end of file
diff --git a/docs/ja/query_language/operators.md b/docs/ja/query_language/operators.md
new file mode 120000
index 00000000000..f94df928a82
--- /dev/null
+++ b/docs/ja/query_language/operators.md
@@ -0,0 +1 @@
+../../en/query_language/operators.md
\ No newline at end of file
diff --git a/docs/ja/query_language/select.md b/docs/ja/query_language/select.md
new file mode 120000
index 00000000000..c8ec8369383
--- /dev/null
+++ b/docs/ja/query_language/select.md
@@ -0,0 +1 @@
+../../en/query_language/select.md
\ No newline at end of file
diff --git a/docs/ja/query_language/show.md b/docs/ja/query_language/show.md
new file mode 120000
index 00000000000..4c2f4cf2c4f
--- /dev/null
+++ b/docs/ja/query_language/show.md
@@ -0,0 +1 @@
+../../en/query_language/show.md
\ No newline at end of file
diff --git a/docs/ja/query_language/syntax.md b/docs/ja/query_language/syntax.md
new file mode 120000
index 00000000000..5307fd51ae8
--- /dev/null
+++ b/docs/ja/query_language/syntax.md
@@ -0,0 +1 @@
+../../en/query_language/syntax.md
\ No newline at end of file
diff --git a/docs/ja/query_language/system.md b/docs/ja/query_language/system.md
new file mode 120000
index 00000000000..6061858c3f2
--- /dev/null
+++ b/docs/ja/query_language/system.md
@@ -0,0 +1 @@
+../../en/query_language/system.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/file.md b/docs/ja/query_language/table_functions/file.md
new file mode 120000
index 00000000000..a514547109a
--- /dev/null
+++ b/docs/ja/query_language/table_functions/file.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/file.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/hdfs.md b/docs/ja/query_language/table_functions/hdfs.md
new file mode 120000
index 00000000000..2616e737eb6
--- /dev/null
+++ b/docs/ja/query_language/table_functions/hdfs.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/hdfs.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/index.md b/docs/ja/query_language/table_functions/index.md
new file mode 120000
index 00000000000..89b22522859
--- /dev/null
+++ b/docs/ja/query_language/table_functions/index.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/index.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/input.md b/docs/ja/query_language/table_functions/input.md
new file mode 120000
index 00000000000..f23cc8ee673
--- /dev/null
+++ b/docs/ja/query_language/table_functions/input.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/input.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/jdbc.md b/docs/ja/query_language/table_functions/jdbc.md
new file mode 120000
index 00000000000..73bec80ca58
--- /dev/null
+++ b/docs/ja/query_language/table_functions/jdbc.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/jdbc.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/merge.md b/docs/ja/query_language/table_functions/merge.md
new file mode 120000
index 00000000000..383f6c88331
--- /dev/null
+++ b/docs/ja/query_language/table_functions/merge.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/merge.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/mysql.md b/docs/ja/query_language/table_functions/mysql.md
new file mode 120000
index 00000000000..75c032cc63f
--- /dev/null
+++ b/docs/ja/query_language/table_functions/mysql.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/mysql.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/numbers.md b/docs/ja/query_language/table_functions/numbers.md
new file mode 120000
index 00000000000..a679b915669
--- /dev/null
+++ b/docs/ja/query_language/table_functions/numbers.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/numbers.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/odbc.md b/docs/ja/query_language/table_functions/odbc.md
new file mode 120000
index 00000000000..7620f920494
--- /dev/null
+++ b/docs/ja/query_language/table_functions/odbc.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/odbc.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/remote.md b/docs/ja/query_language/table_functions/remote.md
new file mode 120000
index 00000000000..b157c4076d3
--- /dev/null
+++ b/docs/ja/query_language/table_functions/remote.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/remote.md
\ No newline at end of file
diff --git a/docs/ja/query_language/table_functions/url.md b/docs/ja/query_language/table_functions/url.md
new file mode 120000
index 00000000000..038e08f7ba9
--- /dev/null
+++ b/docs/ja/query_language/table_functions/url.md
@@ -0,0 +1 @@
+../../../en/query_language/table_functions/url.md
\ No newline at end of file
diff --git a/docs/ja/roadmap.md b/docs/ja/roadmap.md
new file mode 120000
index 00000000000..24df86352b3
--- /dev/null
+++ b/docs/ja/roadmap.md
@@ -0,0 +1 @@
+../en/roadmap.md
\ No newline at end of file
diff --git a/docs/ja/security_changelog.md b/docs/ja/security_changelog.md
new file mode 120000
index 00000000000..101a4f4e48c
--- /dev/null
+++ b/docs/ja/security_changelog.md
@@ -0,0 +1 @@
+../en/security_changelog.md
\ No newline at end of file
diff --git a/docs/redirects.txt b/docs/redirects.txt
index 0ff077b660c..b38f6d242f2 100644
--- a/docs/redirects.txt
+++ b/docs/redirects.txt
@@ -1,3 +1,4 @@
+introduction/ya_metrika_task.md introduction/history.md
 system_tables.md operations/system_tables.md
 system_tables/system.asynchronous_metrics.md operations/system_tables.md
 system_tables/system.clusters.md operations/system_tables.md
diff --git a/docs/ru/getting_started/index.md b/docs/ru/getting_started/index.md
index c03ac58f24b..a8d0fbaa5b1 100644
--- a/docs/ru/getting_started/index.md
+++ b/docs/ru/getting_started/index.md
@@ -1,138 +1,10 @@
 # Начало работы
 
-## Системные требования
+Если вы новичок в ClickHouse и хотите получить вживую оценить его производительность, прежде всего нужно пройти через [процесс установки](install.md).
 
-ClickHouse может работать на любом Linux, FreeBSD или Mac OS X с архитектурой процессора x86\_64.
+После этого можно выбрать один из следующих вариантов:
 
-Хотя предсобранные релизы обычно компилируются с использованием набора инструкций SSE 4.2, что добавляет использование поддерживающего его процессора в список системных требований. Команда для проверки наличия поддержки инструкций SSE 4.2 на текущем процессоре:
-
-```bash
-$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
-```
-
-## Установка
-
-### Из DEB пакетов
-
-Яндекс рекомендует использовать официальные скомпилированные `deb` пакеты для Debian или Ubuntu.
-
-Чтобы установить официальные пакеты, пропишите репозиторий Яндекса в `/etc/apt/sources.list` или в отдельный файл `/etc/apt/sources.list.d/clickhouse.list`:
-
-```bash
-$ deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
-```
-
-Если вы хотите использовать наиболее свежую тестовую, замените `stable` на `testing` (не рекомендуется для production окружений).
-
-Затем для самой установки пакетов выполните:
-
-```bash
-$ sudo apt-get install dirmngr    # optional
-$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
-$ sudo apt-get update
-$ sudo apt-get install clickhouse-client clickhouse-server
-```
-
-Также эти пакеты можно скачать и установить вручную отсюда: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
-
-### Из RPM пакетов
-
-Команда ClickHouse в Яндексе рекомендует использовать официальные предкомпилированные `rpm` пакеты для CentOS, RedHad и всех остальных дистрибутивов Linux, основанных на rpm.
-
-Сначала нужно подключить официальный репозиторий:
-```bash
-$ sudo yum install yum-utils
-$ sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
-$ sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
-```
-
-Для использования наиболее свежих версий нужно заменить `stable` на `testing` (рекомендуется для тестовых окружений).
-
-Then run these commands to actually install packages:
-Для, собственно, установки пакетов необходимо выполнить следующие команды:
-
-```bash
-$ sudo yum install clickhouse-server clickhouse-client
-```
-
-Также есть возможность установить пакеты вручную, скачав отсюда: <https://repo.yandex.ru/clickhouse/rpm/stable/x86_64>.
-
-### Из Docker образа
-
-Для запуска ClickHouse в Docker нужно следовать инструкции на [Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/). Внутри образов используются официальные `deb` пакеты.
-
-### Из исходного кода
-
-Для компиляции ClickHouse вручную, используйте инструкцию для [Linux](../development/build.md) или [Mac OS X](../development/build_osx.md).
-
-Можно скомпилировать пакеты и установить их, либо использовать программы без установки пакетов. Также при ручной сборке можно отключить необходимость поддержки набора инструкций SSE 4.2 или собрать под процессоры архитектуры AArch64.
-
-```text
-Client: dbms/programs/clickhouse-client
-Server: dbms/programs/clickhouse-server
-```
-
-Для работы собранного вручную сервера необходимо создать директории для данных и метаданных, а также сделать их `chown` для желаемого пользователя. Пути к этим директориям могут быть изменены в конфигурационном файле сервера (src/dbms/programs/server/config.xml), по умолчанию используются следующие:
-
-```text
-/opt/clickhouse/data/default/
-/opt/clickhouse/metadata/default/
-```
-
-На Gentoo для установки ClickHouse из исходного кода можно использовать просто `emerge clickhouse`.
-
-## Запуск
-
-Для запуска сервера в качестве демона, выполните:
-
-```bash
-$ sudo service clickhouse-server start
-```
-
-Смотрите логи в директории `/var/log/clickhouse-server/`.
-
-Если сервер не стартует, проверьте корректность конфигурации в файле `/etc/clickhouse-server/config.xml`
-
-Также можно запустить сервер вручную из консоли:
-
-```bash
-$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml
-```
-
-При этом, лог будет выводиться в консоль, что удобно для разработки.
-Если конфигурационный файл лежит в текущей директории, то указывать параметр `--config-file` не требуется, по умолчанию будет использован файл `./config.xml`.
-
-После запуска сервера, соединиться с ним можно с помощью клиента командной строки:
-
-```bash
-$ clickhouse-client
-```
-
-По умолчанию он соединяется с localhost:9000, от имени пользователя `default` без пароля. Также клиент может быть использован для соединения с удалённым сервером с помощью аргумента `--host`.
-
-Терминал должен использовать кодировку UTF-8.
-
-Более подробная информация о клиенте располагается в разделе [«Клиент командной строки»](../interfaces/cli.md).
-
-Пример проверки работоспособности системы:
-
-```bash
-$ ./clickhouse-client
-ClickHouse client version 0.0.18749.
-Connecting to localhost:9000.
-Connected to ClickHouse server version 0.0.18749.
-```
-```sql
-SELECT 1
-```
-```text
-┌─1─┐
-│ 1 │
-└───┘
-```
-
-**Поздравляем, система работает!**
-
-Для дальнейших экспериментов можно попробовать загрузить один из тестовых наборов данных или пройти [пошаговое руководство для начинающих](https://clickhouse.yandex/tutorial.html).
+* [Пройти подробное руководство для начинающих](tutorial.md)
+* [Поэкспериментировать с тестовыми наборами данных](example_datasets/ontime.md)
 
 [Оригинальная статья](https://clickhouse.yandex/docs/ru/getting_started/) <!--hide-->
diff --git a/docs/ru/getting_started/install.md b/docs/ru/getting_started/install.md
new file mode 100644
index 00000000000..29ccd2b14f4
--- /dev/null
+++ b/docs/ru/getting_started/install.md
@@ -0,0 +1,144 @@
+# Установка
+
+## Системные требования
+
+ClickHouse может работать на любой операционной системе Linux, FreeBSD или Mac OS X с архитектурой процессора x86\_64, AArch64 или PowerPC64LE.
+
+Предварительно собранные пакеты компилируются для x86\_64 и используют набор инструкций SSE 4.2, поэтому, если не указано иное, его поддержка в используемом процессоре, становится дополнительным требованием к системе. Вот команда, чтобы проверить, поддерживает ли текущий процессор SSE 4.2:
+
+``` bash
+$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
+```
+
+Чтобы запустить ClickHouse на процессорах, которые не поддерживают SSE 4.2, либо имеют архитектуру AArch64 или PowerPC64LE, необходимо самостоятельно [собрать ClickHouse из исходного кода](#from-sources) с соответствующими настройками конфигурации.
+
+## Доступные варианты установки
+
+### Из DEB пакетов {#from-deb-packages}
+
+Яндекс рекомендует использовать официальные скомпилированные `deb` пакеты для Debian или Ubuntu.
+
+Чтобы установить официальные пакеты, пропишите репозиторий Яндекса в `/etc/apt/sources.list` или в отдельный файл `/etc/apt/sources.list.d/clickhouse.list`:
+
+```
+deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
+```
+
+Если вы хотите использовать наиболее свежую тестовую, замените `stable` на `testing` (не рекомендуется для production окружений).
+
+Затем для самой установки пакетов выполните:
+
+```bash
+sudo apt-get install dirmngr    # optional
+sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
+sudo apt-get update
+sudo apt-get install clickhouse-client clickhouse-server
+```
+
+Также эти пакеты можно скачать и установить вручную отсюда: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
+
+### Из RPM пакетов {#from-rpm-packages}
+
+Команда ClickHouse в Яндексе рекомендует использовать официальные предкомпилированные `rpm` пакеты для CentOS, RedHad и всех остальных дистрибутивов Linux, основанных на rpm.
+
+Сначала нужно подключить официальный репозиторий:
+```bash
+sudo yum install yum-utils
+sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
+sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
+```
+
+Для использования наиболее свежих версий нужно заменить `stable` на `testing` (рекомендуется для тестовых окружений).
+
+Then run these commands to actually install packages:
+Для, собственно, установки пакетов необходимо выполнить следующие команды:
+
+```bash
+sudo yum install clickhouse-server clickhouse-client
+```
+
+Также есть возможность установить пакеты вручную, скачав отсюда: <https://repo.yandex.ru/clickhouse/rpm/stable/x86_64>.
+
+### Из Docker образа {#from-docker-image}
+
+Для запуска ClickHouse в Docker нужно следовать инструкции на [Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/). Внутри образов используются официальные `deb` пакеты.
+
+### Из исходного кода {#from-sources}
+
+Для компиляции ClickHouse вручную, используйте инструкцию для [Linux](../development/build.md) или [Mac OS X](../development/build_osx.md).
+
+Можно скомпилировать пакеты и установить их, либо использовать программы без установки пакетов. Также при ручой сборке можно отключить необходимость поддержки набора инструкций SSE 4.2 или собрать под процессоры архитектуры AArch64.
+
+```
+Client: dbms/programs/clickhouse-client
+Server: dbms/programs/clickhouse-server
+```
+
+Для работы собранного вручную сервера необходимо создать директории для данных и метаданных, а также сделать их `chown` для желаемого пользователя. Пути к этим директориям могут быть изменены в конфигурационном файле сервера (src/dbms/programs/server/config.xml), по умолчанию используются следующие:
+
+```
+/opt/clickhouse/data/default/
+/opt/clickhouse/metadata/default/
+```
+
+На Gentoo для установки ClickHouse из исходного кода можно использовать просто `emerge clickhouse`.
+
+## Запуск
+
+Для запуска сервера в качестве демона, выполните:
+
+``` bash
+$ sudo service clickhouse-server start
+```
+
+Смотрите логи в директории `/var/log/clickhouse-server/`.
+
+Если сервер не стартует, проверьте корректность конфигурации в файле `/etc/clickhouse-server/config.xml`
+
+Также можно запустить сервер вручную из консоли:
+
+``` bash
+$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml
+```
+
+При этом, лог будет выводиться в консоль, что удобно для разработки.
+Если конфигурационный файл лежит в текущей директории, то указывать параметр `--config-file` не требуется, по умолчанию будет использован файл `./config.xml`.
+
+После запуска сервера, соединиться с ним можно с помощью клиента командной строки:
+
+``` bash
+$ clickhouse-client
+```
+
+По умолчанию он соединяется с localhost:9000, от имени пользователя `default` без пароля. Также клиент может быть использован для соединения с удалённым сервером с помощью аргумента `--host`.
+
+Терминал должен использовать кодировку UTF-8.
+
+Более подробная информация о клиенте располагается в разделе [«Клиент командной строки»](../interfaces/cli.md).
+
+Пример проверки работоспособности системы:
+
+``` bash
+$ ./clickhouse-client
+ClickHouse client version 0.0.18749.
+Connecting to localhost:9000.
+Connected to ClickHouse server version 0.0.18749.
+
+:) SELECT 1
+
+SELECT 1
+
+┌─1─┐
+│ 1 │
+└───┘
+
+1 rows in set. Elapsed: 0.003 sec.
+
+:)
+```
+
+**Поздравляем, система работает!**
+
+Для дальнейших экспериментов можно попробовать загрузить один из тестовых наборов данных или пройти [пошаговое руководство для начинающих](https://clickhouse.yandex/tutorial.html).
+
+[Оригинальная статья](https://clickhouse.yandex/docs/ru/getting_started/install/) <!--hide-->
diff --git a/docs/ru/getting_started/tutorial.md b/docs/ru/getting_started/tutorial.md
new file mode 120000
index 00000000000..8bc40816ab2
--- /dev/null
+++ b/docs/ru/getting_started/tutorial.md
@@ -0,0 +1 @@
+../../en/getting_started/tutorial.md
\ No newline at end of file
diff --git a/docs/ru/introduction/ya_metrika_task.md b/docs/ru/introduction/history.md
similarity index 99%
rename from docs/ru/introduction/ya_metrika_task.md
rename to docs/ru/introduction/history.md
index c7e22346ae5..c0035b51f82 100644
--- a/docs/ru/introduction/ya_metrika_task.md
+++ b/docs/ru/introduction/history.md
@@ -1,4 +1,4 @@
-# Постановка задачи в Яндекс.Метрике
+# История ClickHouse
 
 ClickHouse изначально разрабатывался для обеспечения работы [Яндекс.Метрики](https://metrika.yandex.ru/), [второй крупнейшей в мире](http://w3techs.com/technologies/overview/traffic_analysis/all) платформы для веб аналитики, и продолжает быть её ключевым компонентом. При более 13 триллионах записей в базе данных и более 20 миллиардах событий в сутки, ClickHouse позволяет генерировать индивидуально настроенные отчёты на лету напрямую из неагрегированных данных. Данная статья вкратце демонстрирует какие цели исторически стояли перед ClickHouse на ранних этапах его развития.
 
diff --git a/docs/toc_en.yml b/docs/toc_en.yml
index 5ed9265b3bc..8a2b32b240a 100644
--- a/docs/toc_en.yml
+++ b/docs/toc_en.yml
@@ -5,10 +5,12 @@ nav:
   - 'Distinctive Features of ClickHouse': 'introduction/distinctive_features.md'
   - 'ClickHouse Features that Can Be Considered Disadvantages': 'introduction/features_considered_disadvantages.md'
   - 'Performance': 'introduction/performance.md'
-  - 'The Yandex.Metrica Task': 'introduction/ya_metrika_task.md'
+  - 'History': 'introduction/history.md'
 
 - 'Getting Started':
-  - 'Deploying and Running': 'getting_started/index.md'
+  - 'hidden': 'getting_started/index.md'
+  - 'Installation': 'getting_started/install.md'
+  - 'Tutorial': 'getting_started/tutorial.md'
   - 'Example Datasets':
     - 'OnTime': 'getting_started/example_datasets/ontime.md'
     - 'New York Taxi Data': 'getting_started/example_datasets/nyc_taxi.md'
diff --git a/docs/toc_fa.yml b/docs/toc_fa.yml
index 207034a8718..30de03f320a 100644
--- a/docs/toc_fa.yml
+++ b/docs/toc_fa.yml
@@ -1,15 +1,17 @@
 nav:
 
-- 'Introduction':
+- 'ﯽﻓﺮﻌﻣ':
   - 'ClickHouse چیست؟': 'index.md'
   - ' ویژگی های برجسته ClickHouse': 'introduction/distinctive_features.md'
   - ' ویژگی های از ClickHouse که می تواند معایبی باشد': 'introduction/features_considered_disadvantages.md'
-  - 'Performance': 'introduction/performance.md'
-  - 'The Yandex.Metrica task': 'introduction/ya_metrika_task.md'
+  - 'ﯽﯾﺍﺭﺎﮐ': 'introduction/performance.md'
+  - 'ﺦﯾﺭﺎﺗ': 'introduction/history.md'
 
 - 'Getting started':
-  - ' شروع به کار': 'getting_started/index.md'
-  - 'Example datasets':
+  - 'hidden': 'getting_started/index.md'
+  - 'ﯼﺯﺍﺪﻧﺍ ﻩﺍﺭ ﻭ ﺐﺼﻧ': 'getting_started/install.md'
+  - 'ﺵﺯﻮﻣﺁ': 'getting_started/tutorial.md'
+  - 'ﻪﻧﻮﻤﻧ ﯼﺎﻫ ﻩﺩﺍﺩ ﻪﻋﻮﻤﺠﻣ':
     - 'OnTime': 'getting_started/example_datasets/ontime.md'
     - ' داده های تاکسی New York': 'getting_started/example_datasets/nyc_taxi.md'
     - ' بنچمارک AMPLab Big Data': 'getting_started/example_datasets/amplab_benchmark.md'
@@ -18,7 +20,7 @@ nav:
     - ' بنچمارک Star Schema': 'getting_started/example_datasets/star_schema.md'
     - 'Yandex.Metrica Data': 'getting_started/example_datasets/metrica.md'
 
-- 'Interfaces':
+- 'ﻂﺑﺍﺭ':
   - 'Interface ها': 'interfaces/index.md'
   - ' کلاینت Command-line': 'interfaces/cli.md'
   - 'Native interface (TCP)': 'interfaces/tcp.md'
@@ -33,7 +35,7 @@ nav:
     - 'رابط های بصری': 'interfaces/third-party/gui.md'
     - 'پروکسی': 'interfaces/third-party/proxy.md'
 
-- 'Data types':
+- 'ﻩﺩﺍﺩ ﻉﺍﻮﻧﺍ':
   - 'Introduction': 'data_types/index.md'
   - 'UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64': 'data_types/int_uint.md'
   - 'Float32, Float64': 'data_types/float.md'
diff --git a/docs/toc_ja.yml b/docs/toc_ja.yml
index 3c4a5506a06..d96963953fe 100644
--- a/docs/toc_ja.yml
+++ b/docs/toc_ja.yml
@@ -5,10 +5,12 @@ nav:
   - 'Distinctive Features of ClickHouse': 'introduction/distinctive_features.md'
   - 'ClickHouse Features that Can Be Considered Disadvantages': 'introduction/features_considered_disadvantages.md'
   - 'Performance': 'introduction/performance.md'
-  - 'The Yandex.Metrica Task': 'introduction/ya_metrika_task.md'
+  - 'History': 'introduction/history.md'
 
 - 'Getting Started':
-  - 'Deploying and Running': 'getting_started/index.md'
+  - 'hidden': 'getting_started/index.md'
+  - 'Installation': 'getting_started/install.md'
+  - 'Tutorial': 'getting_started/tutorial.md'
   - 'Example Datasets':
     - 'OnTime': 'getting_started/example_datasets/ontime.md'
     - 'New York Taxi Data': 'getting_started/example_datasets/nyc_taxi.md'
@@ -215,8 +217,9 @@ nav:
   - 'Overview of ClickHouse Architecture': 'development/architecture.md'
   - 'How to Build ClickHouse on Linux': 'development/build.md'
   - 'How to Build ClickHouse on Mac OS X': 'development/build_osx.md'
-  - 'How to Build ClickHouse on Linux for Mac OS X': 'development/build_cross.md'
-  - 'How to Write C++ code': 'development/style.md'
+  - 'How to Build ClickHouse on Linux for Mac OS X': 'development/build_cross_osx.md'
+  - 'How to Build ClickHouse on Linux for AARCH64 (ARM64)': 'development/build_cross_arm.md'
+  - 'How to Write C++ Code': 'development/style.md'
   - 'How to Run ClickHouse Tests': 'development/tests.md'
   - 'The Beginner ClickHouse Developer Instruction': 'development/developer_instruction.md'
   - 'Third-Party Libraries Used': 'development/contrib.md'
diff --git a/docs/toc_ru.yml b/docs/toc_ru.yml
index 5c71894c8f6..9e4b948cc02 100644
--- a/docs/toc_ru.yml
+++ b/docs/toc_ru.yml
@@ -5,11 +5,13 @@ nav:
   - 'Отличительные возможности ClickHouse': 'introduction/distinctive_features.md'
   - 'Особенности ClickHouse, которые могут считаться недостатками': 'introduction/features_considered_disadvantages.md'
   - 'Производительность': 'introduction/performance.md'
-  - 'Постановка задачи в Яндекс.Метрике': 'introduction/ya_metrika_task.md'
+  - 'История': 'introduction/history.md'
   - 'Информационная поддержка': 'introduction/info.md'
 
 - 'Начало работы':
-  - 'Установка и запуск': 'getting_started/index.md'
+  - 'hidden': 'getting_started/index.md'
+  - 'Установка': 'getting_started/install.md'
+  - 'Руководство для начинающих': 'getting_started/tutorial.md'
   - 'Тестовые наборы данных':
     - 'OnTime': 'getting_started/example_datasets/ontime.md'
     - 'Данные о такси в Нью-Йорке': 'getting_started/example_datasets/nyc_taxi.md'
@@ -214,7 +216,7 @@ nav:
   - 'Обзор архитектуры ClickHouse': 'development/architecture.md'
   - 'Как собрать ClickHouse на Linux': 'development/build.md'
   - 'Как собрать ClickHouse на Mac OS X': 'development/build_osx.md'
-  - 'Как собрать ClickHouse на Linux для Mac OS X': 'development/build_cross.md'
+  - 'Как собрать ClickHouse на Linux для Mac OS X': 'development/build_cross_osx.md'
   - 'Как писать код на C++': 'development/style.md'
   - 'Как запустить тесты': 'development/tests.md'
   - 'Инструкция для начинающего разработчика ClickHouse': 'development/developer_instruction.md'
diff --git a/docs/toc_zh.yml b/docs/toc_zh.yml
index c8be2ad7606..3f19fe3f72b 100644
--- a/docs/toc_zh.yml
+++ b/docs/toc_zh.yml
@@ -5,10 +5,12 @@ nav:
   - 'ClickHouse的独特功能': 'introduction/distinctive_features.md'
   - 'ClickHouse功能可被视为缺点': 'introduction/features_considered_disadvantages.md'
   - '性能': 'introduction/performance.md'
-  - 'Yandex.Metrica使用案例': 'introduction/ya_metrika_task.md'
+  - '历史': 'introduction/history.md'
 
 - '入门指南':
-  - '部署运行': 'getting_started/index.md'
+  - 'hidden': 'getting_started/index.md'
+  - '安装': 'getting_started/install.md'
+  - '教程': 'getting_started/tutorial.md'
   - '示例数据集':
     - '航班飞行数据': 'getting_started/example_datasets/ontime.md'
     - '纽约市出租车数据': 'getting_started/example_datasets/nyc_taxi.md'
@@ -16,6 +18,7 @@ nav:
     - '维基访问数据': 'getting_started/example_datasets/wikistat.md'
     - 'Criteo TB级别点击日志': 'getting_started/example_datasets/criteo.md'
     - 'Star Schema基准测试': 'getting_started/example_datasets/star_schema.md'
+    - 'Yandex.Metrica': 'getting_started/example_datasets/metrica.md'
 
 - '客户端':
   - '介绍': 'interfaces/index.md'
@@ -212,7 +215,7 @@ nav:
   - 'ClickHouse架构概述': 'development/architecture.md'
   - '如何在Linux中编译ClickHouse': 'development/build.md'
   - '如何在Mac OS X中编译ClickHouse': 'development/build_osx.md'
-  - '如何在Linux中编译Mac OS X ClickHouse': 'development/build_cross.md'
+  - '如何在Linux中编译Mac OS X ClickHouse': 'development/build_cross_osx.md'
   - '如何编写C++代码': 'development/style.md'
   - '如何运行ClickHouse测试': 'development/tests.md'
   - '开发者指南': 'development/developer_instruction.md'
diff --git a/docs/tools/make_links.sh b/docs/tools/make_links.sh
index 084f8b9d97b..04c51424ec8 100755
--- a/docs/tools/make_links.sh
+++ b/docs/tools/make_links.sh
@@ -11,7 +11,7 @@ function do_make_links()
     for lang in "${langs[@]}"
     do
         # replacing "/./" with /
-        dst_file="../${lang}/${src_file}"
+        dst_file="../${lang}${src_file}"
         dst_file="${dst_file/\/\.\//\/}"
 
         mkdir -p $(dirname "${dst_file}")
diff --git a/docs/tools/mkdocs-material-theme/assets/flags/ja.svg b/docs/tools/mkdocs-material-theme/assets/flags/ja.svg
index 177d0e78819..a666c272523 100644
--- a/docs/tools/mkdocs-material-theme/assets/flags/ja.svg
+++ b/docs/tools/mkdocs-material-theme/assets/flags/ja.svg
@@ -1,5 +1,8 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="900" height="600">
-<rect fill="#a0a0a0" height="600" width="900"/>
-<rect fill="#fff" x="6" y="6" width="888" height="588"/>
-<circle fill="#be0026" cx="450" cy="300" r="180"/>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="90px" height="60px" viewBox="0 0 90 60" version="1.1">
+<g id="surface1">
+<rect x="0" y="0" width="90" height="60" style="fill:rgb(62.7451%,62.7451%,62.7451%);fill-opacity:1;stroke:none;"/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 0.601562 0.601562 L 89.398438 0.601562 L 89.398438 59.398438 L 0.601562 59.398438 Z M 0.601562 0.601562 "/>
+<path style=" stroke:none;fill-rule:nonzero;fill:rgb(74.509805%,0%,14.901961%);fill-opacity:1;" d="M 63 30 C 63 39.941406 54.941406 48 45 48 C 35.058594 48 27 39.941406 27 30 C 27 20.058594 35.058594 12 45 12 C 54.941406 12 63 20.058594 63 30 Z M 63 30 "/>
+</g>
 </svg>
diff --git a/docs/tools/mkdocs-material-theme/partials/language/ja.html b/docs/tools/mkdocs-material-theme/partials/language/ja.html
index 09c3b291fed..47341ab06ee 100644
--- a/docs/tools/mkdocs-material-theme/partials/language/ja.html
+++ b/docs/tools/mkdocs-material-theme/partials/language/ja.html
@@ -7,6 +7,12 @@
   "footer.next": "次",
   "meta.comments": "コメント",
   "meta.source": "ソース",
+  "nav.latest": "master",
+  "nav.multi_page": "マルチページ版",
+  "nav.pdf": "PDF版",
+  "nav.release": "リリース",
+  "nav.single_page": "シングルページ版",
+  "nav.source": "ClickHouseソースコード",
   "search.placeholder": "検索",
   "search.result.placeholder": "検索キーワードを入力してください",
   "search.result.none": "何も見つかりませんでした",
diff --git a/docs/zh/getting_started/example_datasets/metrica.md b/docs/zh/getting_started/example_datasets/metrica.md
new file mode 120000
index 00000000000..984023973eb
--- /dev/null
+++ b/docs/zh/getting_started/example_datasets/metrica.md
@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/metrica.md
\ No newline at end of file
diff --git a/docs/zh/getting_started/index.md b/docs/zh/getting_started/index.md
index b1c94600da0..c73181a6068 100644
--- a/docs/zh/getting_started/index.md
+++ b/docs/zh/getting_started/index.md
@@ -1,154 +1,10 @@
-# 入门指南
+# 入门
 
-## 系统要求
+如果您是ClickHouse的新手，并希望亲身体验它的性能，首先您需要通过 [安装过程](install.md).
 
-如果从官方仓库安装，需要确保您使用的是x86\_64处理器构架的Linux并且支持SSE 4.2指令集
+之后，您可以选择以下选项之一：
 
-检查是否支持SSE 4.2：
+* [通过详细的教程](tutorial.md)
+* [试验示例数据集](example_datasets/ontime.md)
 
-```bash
-grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
-```
-
-我们推荐使用Ubuntu或者Debian。终端必须使用UTF-8编码。
-
-基于rpm的系统,你可以使用第三方的安装包：https://packagecloud.io/altinity/clickhouse 或者直接安装debian安装包。
-
-ClickHouse还可以在FreeBSD与Mac OS X上工作。同时它可以在不支持SSE 4.2的x86\_64构架和AArch64 CPUs上编译。
-
-## 安装
-
-### 为Debian/Ubuntu安装
-
-在`/etc/apt/sources.list` (或创建`/etc/apt/sources.list.d/clickhouse.list`文件)中添加仓库：
-
-```bash
-$ deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
-```
-
-如果你想使用最新的测试版本，请使用'testing'替换'stable'。
-
-然后运行：
-
-```bash
-$ sudo apt-get install dirmngr    # optional
-$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
-$ sudo apt-get update
-$ sudo apt-get install clickhouse-client clickhouse-server
-```
-
-你也可以从这里手动下载安装包：<https://repo.yandex.ru/clickhouse/deb/stable/main/>。
-
-ClickHouse包含访问控制配置，它们位于`users.xml`文件中(与'config.xml'同目录)。
-默认情况下，允许从任何地方使用默认的‘default’用户无密码的访问ClickHouse。参考‘user/default/networks’。
-有关更多信息，请参考"Configuration files"部分。
-
-###为CentOS/RedHat安装
-
-Yandex ClickHouse团队建议使用官方预编译的`rpm`软件包，用于CentOS，RedHat和所有其他基于rpm的Linux发行版。
-
-首先，您需要添加官方存储库：
-
-```bash
-$ sudo yum install yum-utils
-$ sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
-$ sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
-```
-
-如果您想使用最新版本，请将`stable`替换为`testing`（建议您在测试环境中使用）。
-
-然后运行这些命令以实际安装包：
-
-```bash
-$ sudo yum install clickhouse-server clickhouse-client
-```
-
-您也可以从此处手动下载和安装软件包：<https://repo.yandex.ru/clickhouse/rpm/stable/x86_64>。
-
-###使用Docker安装
-
-要在Docker中运行ClickHouse，请遵循[Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/)上的指南。这些镜像使用官方的`deb`包构建。
-
-### 使用源码安装
-
-具体编译方式可以参考build.md。
-
-你可以编译并安装它们。
-你也可以直接使用而不进行安装。
-
-```text
-Client: dbms/programs/clickhouse-client
-Server: dbms/programs/clickhouse-server
-```
-
-在服务器中为数据创建如下目录：
-
-```text
-/opt/clickhouse/data/default/
-/opt/clickhouse/metadata/default/
-```
-
-(它们可以在server config中配置。)
-为需要的用户运行‘chown’
-
-日志的路径可以在server config (src/dbms/programs/server/config.xml)中配置。
-
-## 启动
-
-可以运行如下命令在后台启动服务：
-
-```bash
-sudo service clickhouse-server start
-```
-
-可以在`/var/log/clickhouse-server/`目录中查看日志。
-
-如果服务没有启动，请检查配置文件 `/etc/clickhouse-server/config.xml`。
-
-你也可以在控制台中直接启动服务：
-
-```bash
-clickhouse-server --config-file=/etc/clickhouse-server/config.xml
-```
-
-在这种情况下，日志将被打印到控制台中，这在开发过程中很方便。
-如果配置文件在当前目录中，你可以不指定‘--config-file’参数。它默认使用‘./config.xml’。
-
-你可以使用命令行客户端连接到服务：
-
-```bash
-clickhouse-client
-```
-
-默认情况下它使用‘default’用户无密码的与localhost:9000服务建立连接。
-客户端也可以用于连接远程服务，例如：
-
-```bash
-clickhouse-client --host=example.com
-```
-
-有关更多信息，请参考"Command-line client"部分。
-
-检查系统是否工作：
-
-```bash
-milovidov@hostname:~/work/metrica/src/dbms/src/Client$ ./clickhouse-client
-ClickHouse client version 0.0.18749.
-Connecting to localhost:9000.
-Connected to ClickHouse server version 0.0.18749.
-```
-```sql
-:) SELECT 1
-```
-```text
-┌─1─┐
-│ 1 │
-└───┘
-```
-
-**恭喜，系统已经工作了!**
-
-为了继续进行实验，你可以尝试下载测试数据集。
-
-
-[Original article](https://clickhouse.yandex/docs/en/getting_started/) <!--hide-->
+[来源文章](https://clickhouse.yandex/docs/zh/getting_started/) <!--hide-->
diff --git a/docs/zh/getting_started/install.md b/docs/zh/getting_started/install.md
new file mode 100644
index 00000000000..aa3cb816218
--- /dev/null
+++ b/docs/zh/getting_started/install.md
@@ -0,0 +1,152 @@
+## 系统要求
+
+ClickHouse可以在任何具有x86\_64，AArch64或PowerPC64LE CPU架构的Linux，FreeBSD或Mac OS X上运行。
+
+虽然预构建的二进制文件通常是为x86 \ _64编译并利用SSE 4.2指令集，但除非另有说明，否则使用支持它的CPU将成为额外的系统要求。这是检查当前CPU是否支持SSE 4.2的命令：
+
+``` bash
+$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
+```
+
+要在不支持SSE 4.2或具有AArch64或PowerPC64LE体系结构的处理器上运行ClickHouse，您应该[通过源构建ClickHouse](#from-sources)进行适当的配置调整。
+
+##可用的安装选项
+
+### 为Debian/Ubuntu安装 {#from-deb-packages}
+
+在`/etc/apt/sources.list` (或创建`/etc/apt/sources.list.d/clickhouse.list`文件)中添加仓库：
+
+```text
+deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
+```
+
+如果你想使用最新的测试版本，请使用'testing'替换'stable'。
+
+然后运行：
+
+```bash
+sudo apt-get install dirmngr    # optional
+sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4    # optional
+sudo apt-get update
+sudo apt-get install clickhouse-client clickhouse-server
+```
+
+你也可以从这里手动下载安装包：<https://repo.yandex.ru/clickhouse/deb/stable/main/>。
+
+ClickHouse包含访问控制配置，它们位于`users.xml`文件中(与'config.xml'同目录)。
+默认情况下，允许从任何地方使用默认的‘default’用户无密码的访问ClickHouse。参考‘user/default/networks’。
+有关更多信息，请参考"Configuration files"部分。
+
+###来自RPM包 {#from-rpm-packages}
+
+Yandex ClickHouse团队建议使用官方预编译的`rpm`软件包，用于CentOS，RedHat和所有其他基于rpm的Linux发行版。
+
+首先，您需要添加官方存储库：
+
+```bash
+sudo yum install yum-utils
+sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
+sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
+```
+
+如果您想使用最新版本，请将`stable`替换为`testing`（建议您在测试环境中使用）。
+
+然后运行这些命令以实际安装包：
+
+```bash
+sudo yum install clickhouse-server clickhouse-client
+```
+
+您也可以从此处手动下载和安装软件包：<https://repo.yandex.ru/clickhouse/rpm/stable/x86_64>。
+
+###来自Docker {#from-docker-image}
+
+要在Docker中运行ClickHouse，请遵循[Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/)上的指南。那些图像使用官方的`deb`包。
+
+### 使用源码安装 {#from-sources}
+
+具体编译方式可以参考build.md。
+
+你可以编译并安装它们。
+你也可以直接使用而不进行安装。
+
+```text
+Client: dbms/programs/clickhouse-client
+Server: dbms/programs/clickhouse-server
+```
+
+在服务器中为数据创建如下目录：
+
+```text
+/opt/clickhouse/data/default/
+/opt/clickhouse/metadata/default/
+```
+
+(它们可以在server config中配置。)
+为需要的用户运行‘chown’
+
+日志的路径可以在server config (src/dbms/programs/server/config.xml)中配置。
+
+## 启动
+
+可以运行如下命令在后台启动服务：
+
+```bash
+sudo service clickhouse-server start
+```
+
+可以在`/var/log/clickhouse-server/`目录中查看日志。
+
+如果服务没有启动，请检查配置文件 `/etc/clickhouse-server/config.xml`。
+
+你也可以在控制台中直接启动服务：
+
+```bash
+clickhouse-server --config-file=/etc/clickhouse-server/config.xml
+```
+
+在这种情况下，日志将被打印到控制台中，这在开发过程中很方便。
+如果配置文件在当前目录中，你可以不指定‘--config-file’参数。它默认使用‘./config.xml’。
+
+你可以使用命令行客户端连接到服务：
+
+```bash
+clickhouse-client
+```
+
+默认情况下它使用‘default’用户无密码的与localhost:9000服务建立连接。
+客户端也可以用于连接远程服务，例如：
+
+```bash
+clickhouse-client --host=example.com
+```
+
+有关更多信息，请参考"Command-line client"部分。
+
+检查系统是否工作：
+
+```bash
+milovidov@hostname:~/work/metrica/src/dbms/src/Client$ ./clickhouse-client
+ClickHouse client version 0.0.18749.
+Connecting to localhost:9000.
+Connected to ClickHouse server version 0.0.18749.
+
+:) SELECT 1
+
+SELECT 1
+
+┌─1─┐
+│ 1 │
+└───┘
+
+1 rows in set. Elapsed: 0.003 sec.
+
+:)
+```
+
+**恭喜，系统已经工作了!**
+
+为了继续进行实验，你可以尝试下载测试数据集。
+
+
+[Original article](https://clickhouse.yandex/docs/en/getting_started/install/) <!--hide-->
diff --git a/docs/zh/getting_started/tutorial.md b/docs/zh/getting_started/tutorial.md
new file mode 120000
index 00000000000..8bc40816ab2
--- /dev/null
+++ b/docs/zh/getting_started/tutorial.md
@@ -0,0 +1 @@
+../../en/getting_started/tutorial.md
\ No newline at end of file
diff --git a/docs/zh/introduction/ya_metrika_task.md b/docs/zh/introduction/history.md
similarity index 99%
rename from docs/zh/introduction/ya_metrika_task.md
rename to docs/zh/introduction/history.md
index da4b18826e0..86fe02f84d5 100644
--- a/docs/zh/introduction/ya_metrika_task.md
+++ b/docs/zh/introduction/history.md
@@ -1,4 +1,4 @@
-# Yandex.Metrica的使用案例
+# ClickHouse历史
 
 ClickHouse最初是为 [Yandex.Metrica](https://metrica.yandex.com/) [世界第二大Web分析平台](http://w3techs.com/technologies/overview/traffic_analysis/all) 而开发的。多年来一直作为该系统的核心组件被该系统持续使用着。目前为止，该系统在ClickHouse中有超过13万亿条记录，并且每天超过200多亿个事件被处理。它允许直接从原始数据中动态查询并生成报告。本文简要介绍了ClickHouse在其早期发展阶段的目标。
 
diff --git a/website/nginx/default.conf b/website/nginx/default.conf
index 98edad41055..fc029323fe2 100644
--- a/website/nginx/default.conf
+++ b/website/nginx/default.conf
@@ -14,6 +14,8 @@ server {
     }
 
     rewrite ^/docs/$ https://clickhouse.yandex/docs/en/ permanent;
+    rewrite ^/tutorial.html$ https://clickhouse.yandex/docs/en/getting_started/tutorial/ permanent;
+    rewrite ^/presentations/(.*)$ https://clickhouse.github.io/clickhouse-presentations/$1 permanent;
     rewrite ^/reference_en.html$ https://clickhouse.yandex/docs/en/single/ permanent;
     rewrite ^/reference_ru.html$ https://clickhouse.yandex/docs/ru/single/ permanent;
     rewrite ^/presentations/(.*)$ https://clickhouse.github.io/clickhouse-presentations/$1 permanent;
diff --git a/website/tutorial.html b/website/tutorial.html
deleted file mode 100644
index 52216f61dc8..00000000000
--- a/website/tutorial.html
+++ /dev/null
@@ -1,649 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru">
-<head>
-    <meta charset="utf-8"/>
-    <title>ClickHouse Quick Start Guide</title>
-
-    <link rel="shortcut icon" href="favicon.ico"/>
-
-    <meta name="description" content="Quick start guide to ClickHouse — open-source distributed column-oriented DBMS"/>
-    <meta name="keywords"
-          content="tutorial, ClickHouse, DBMS, OLAP, relational, analytics, analytical, big data, open-source, SQL, web-analytics"/>
-
-    <link href="index.css" media="all" rel="stylesheet" />
-</head>
-<body>
-
-<div class="page">
-
-    <div>
-        <div id="tutorial_logo">
-            <a href="/">
-                <svg xmlns="http://www.w3.org/2000/svg" width="90" height="80" viewBox="0 0 9 8">
-                    <path class="red" d="M0,7 h1 v1 h-1 z"></path>
-                    <path class="orange" d="M0,0 h1 v7 h-1 z"></path>
-                    <path class="orange" d="M2,0 h1 v8 h-1 z"></path>
-                    <path class="orange" d="M4,0 h1 v8 h-1 z"></path>
-                    <path class="orange" d="M6,0 h1 v8 h-1 z"></path>
-                    <path class="orange" d="M8,3.25 h1 v1.5 h-1 z"></path>
-                </svg>
-            </a>
-        </div>
-
-        <h1 id="tutorial_title">ClickHouse</h1>
-        <h2 id="tutorial_subtitle">Tutorial</h2>
-    </div>
-
-    <p>Let's get started with sample dataset from open sources. We will use USA civil flights data since 1987 till 2015.
-        It's hard to call this sample a Big Data (contains 166 millions rows, 63 Gb of uncompressed data) but this
-        allows us to quickly get to work. Dataset is available for download <a href="https://yadi.sk/d/pOZxpa42sDdgm">here</a>.
-        Also you may download it from the original datasource <a
-                href="docs/en/getting_started/example_datasets/ontime/"
-                rel="external nofollow">as described here</a>.</p>
-
-    <p>Firstly we will deploy ClickHouse to a single server. Below that we will also review the process of deployment to
-        a cluster with support for sharding and replication.</p>
-
-    <p>On Ubuntu and Debian Linux ClickHouse can be installed from <a href="/#quick-start">packages</a>.
-        For other Linux distributions you can <a href="docs/en/development/build/"
-                                                 rel="external nofollow">compile
-            ClickHouse from sources</a> and then install.</p>
-
-    <p><b>clickhouse-client</b> package contains <a
-            href="docs/en/interfaces/cli/">clickhouse-client</a> application —
-        interactive ClickHouse client. <b>clickhouse-common</b> contains a clickhouse-server binary file. <b>clickhouse-server</b>
-        — contains config files for the clickhouse-server.</p>
-
-    <p>Server config files are located in /etc/clickhouse-server/. Before getting to work please notice the <b>path</b>
-        element in config. <b>Path</b>&nbsp;determines the location for data storage. It's not really handy to directly
-        edit <b>config.xml</b> file considering package updates. Recommended way is to override the config elements in
-        <a href="docs/en/operations/configuration_files/">files of config.d directory</a>.
-        Also you may want to <a href="docs/en/operations/access_rights/">set up access
-            rights</a> at the start.</p>
-
-    <p><b>clickhouse-server</b> won't be launched automatically after package installation. It won't be automatically
-        restarted after updates either. Start the server with:
-    <pre>sudo service clickhouse-server start</pre>
-    Default location for server logs is /var/log/clickhouse-server/
-    Server is ready to handle client connections once "Ready&nbsp;for&nbsp;connections" message was logged.</p>
-
-    <p>Use <b>clickhouse-client</b> to connect to the server.</p>
-
-    <div class="spoiler"><a class="spoiler_title">Tips for clickhouse-client</a>
-        <div class="spoiler_body">
-            Interactive mode:
-<pre>
-clickhouse-client
-clickhouse-client --host=... --port=... --user=... --password=...
-</pre>
-            Enable multiline queries:
-<pre>
-clickhouse-client -m
-clickhouse-client --multiline
-</pre>
-            Run queries in batch-mode:
-<pre>
-clickhouse-client --query='SELECT 1'
-echo 'SELECT 1' | clickhouse-client
-</pre>
-            Insert data from file of a specified format:
-<pre>
-clickhouse-client --query='INSERT INTO table VALUES' &lt; data.txt
-clickhouse-client --query='INSERT INTO table FORMAT TabSeparated' &lt; data.tsv
-</pre>
-        </div>
-    </div>
-
-    <h3>Create table for sample dataset</h3>
-    <div class="spoiler"><a class="spoiler_title">Create table query</a>
-        <div class="spoiler_body">
-<pre>
-$ clickhouse-client --multiline
-ClickHouse client version 0.0.53720.
-Connecting to localhost:9000.
-Connected to ClickHouse server version 0.0.53720.
-
-:) CREATE TABLE ontime
-(
-    Year UInt16,
-    Quarter UInt8,
-    Month UInt8,
-    DayofMonth UInt8,
-    DayOfWeek UInt8,
-    FlightDate Date,
-    UniqueCarrier FixedString(7),
-    AirlineID Int32,
-    Carrier FixedString(2),
-    TailNum String,
-    FlightNum String,
-    OriginAirportID Int32,
-    OriginAirportSeqID Int32,
-    OriginCityMarketID Int32,
-    Origin FixedString(5),
-    OriginCityName String,
-    OriginState FixedString(2),
-    OriginStateFips String,
-    OriginStateName String,
-    OriginWac Int32,
-    DestAirportID Int32,
-    DestAirportSeqID Int32,
-    DestCityMarketID Int32,
-    Dest FixedString(5),
-    DestCityName String,
-    DestState FixedString(2),
-    DestStateFips String,
-    DestStateName String,
-    DestWac Int32,
-    CRSDepTime Int32,
-    DepTime Int32,
-    DepDelay Int32,
-    DepDelayMinutes Int32,
-    DepDel15 Int32,
-    DepartureDelayGroups String,
-    DepTimeBlk String,
-    TaxiOut Int32,
-    WheelsOff Int32,
-    WheelsOn Int32,
-    TaxiIn Int32,
-    CRSArrTime Int32,
-    ArrTime Int32,
-    ArrDelay Int32,
-    ArrDelayMinutes Int32,
-    ArrDel15 Int32,
-    ArrivalDelayGroups Int32,
-    ArrTimeBlk String,
-    Cancelled UInt8,
-    CancellationCode FixedString(1),
-    Diverted UInt8,
-    CRSElapsedTime Int32,
-    ActualElapsedTime Int32,
-    AirTime Int32,
-    Flights Int32,
-    Distance Int32,
-    DistanceGroup UInt8,
-    CarrierDelay Int32,
-    WeatherDelay Int32,
-    NASDelay Int32,
-    SecurityDelay Int32,
-    LateAircraftDelay Int32,
-    FirstDepTime String,
-    TotalAddGTime String,
-    LongestAddGTime String,
-    DivAirportLandings String,
-    DivReachedDest String,
-    DivActualElapsedTime String,
-    DivArrDelay String,
-    DivDistance String,
-    Div1Airport String,
-    Div1AirportID Int32,
-    Div1AirportSeqID Int32,
-    Div1WheelsOn String,
-    Div1TotalGTime String,
-    Div1LongestGTime String,
-    Div1WheelsOff String,
-    Div1TailNum String,
-    Div2Airport String,
-    Div2AirportID Int32,
-    Div2AirportSeqID Int32,
-    Div2WheelsOn String,
-    Div2TotalGTime String,
-    Div2LongestGTime String,
-    Div2WheelsOff String,
-    Div2TailNum String,
-    Div3Airport String,
-    Div3AirportID Int32,
-    Div3AirportSeqID Int32,
-    Div3WheelsOn String,
-    Div3TotalGTime String,
-    Div3LongestGTime String,
-    Div3WheelsOff String,
-    Div3TailNum String,
-    Div4Airport String,
-    Div4AirportID Int32,
-    Div4AirportSeqID Int32,
-    Div4WheelsOn String,
-    Div4TotalGTime String,
-    Div4LongestGTime String,
-    Div4WheelsOff String,
-    Div4TailNum String,
-    Div5Airport String,
-    Div5AirportID Int32,
-    Div5AirportSeqID Int32,
-    Div5WheelsOn String,
-    Div5TotalGTime String,
-    Div5LongestGTime String,
-    Div5WheelsOff String,
-    Div5TailNum String
-)
-ENGINE = MergeTree(FlightDate, (Year, FlightDate), 8192);
-</pre>
-        </div>
-    </div>
-
-    <p>Now we have a table of <a href="docs/en/table_engines/mergetree/">MergeTree type</a>.
-        MergeTree table type is recommended for usage in production. Table of this kind has a primary key used for
-        incremental sort of table data. This allows fast execution of queries in ranges of a primary key.</p>
-
-
-    <p><b>Note</b>
-        We store ad network banners impressions logs in ClickHouse. Each table entry looks like:
-        [Advertiser ID, Impression ID, attribute1, attribute2, &hellip;].
-        Let assume that our aim is to provide a set of reports for each advertiser. Common and frequently demanded query
-        would be to count impressions for a specific Advertiser ID. This means that table primary key should start with
-        Advertiser ID. In this case ClickHouse needs to read smaller amount of data to perform the query for a
-        given Advertiser ID.
-    </p>
-
-    <h3>Load data</h3>
-    <pre>xz -v -c -d &lt; ontime.csv.xz | clickhouse-client --query="INSERT INTO ontime FORMAT CSV"</pre>
-    <p>ClickHouse INSERT query allows to load data in any <a href="docs/en/formats/">supported
-        format</a>. Data load requires just O(1) RAM consumption. INSERT query can receive any data volume as input.
-        It's strongly recommended to insert data with <a
-                href="docs/en/introduction/performance/#performance-when-inserting-data">not too small
-            size blocks</a>. Notice that insert of blocks with size up to max_insert_block_size (= 1&nbsp;048&nbsp;576
-        rows by default) is an atomic operation: data block will be inserted completely or not inserted at all. In case
-        of disconnect during insert operation you may not know if the block was inserted successfully. To achieve
-        exactly-once semantics ClickHouse supports idempotency for <a
-                href="docs/en/table_engines/replication/">replicated tables</a>. This means
-        that you may retry insert of the same data block (possibly on a different replicas) but this block will be
-        inserted just once. Anyway in this guide we will load data from our localhost so we may not take care about data
-        blocks generation and exactly-once semantics.</p>
-
-    <p>INSERT query into tables of MergeTree type is non-blocking (so does a SELECT query). You can execute SELECT
-        queries right after of during insert operation.</p>
-
-    <p>Our sample dataset is a bit not optimal. There are two reasons.</p>
-
-    <p>The first is that String data type is used in cases when <a
-            href="docs/en/data_types/enum/">Enum</a> or numeric type would fit best.</p>
-
-    <p class="tip"><b>⚖</b> When set of possible values is determined and known to be small. (E.g. OS name, browser
-        vendors etc.) it's&nbsp;recommended to use Enums or numbers to improve performance.
-        When set of possible values is not limited (search&nbsp;query, URL, etc.) just go ahead with String.</p>
-
-    <p>The second is that dataset contains redundant fields like Year, Quarter, Month, DayOfMonth, DayOfWeek. In fact a
-        single FlightDate would be enough. Most likely they have been added to improve performance for other DBMS'es
-        which DateTime handling functions may be not efficient.</p>
-
-    <p class="tip"><b>✯</b> ClickHouse <a
-            href="docs/en/functions/date_time_functions/">functions
-        for operating with DateTime fields</a> are well-optimized so such redundancy is not required. Anyway much
-        columns is not a reason to worry — ClickHouse is a <a href="https://en.wikipedia.org/wiki/Column-oriented_DBMS"
-        rel="external nofollow">column-oriented
-            DBMS</a>. This allows you to have as much fields as you need. Hundreds of columns in a table is fine for
-        ClickHouse.</p>
-
-    <h3>Querying the sample dataset</h3>
-
-    <p>Here are some examples of the queries from our test data.</p>
-
-    <ul>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">the most popular destinations in 2015;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT
-    OriginCityName,
-    DestCityName,
-    count(*) AS flights,
-    bar(flights, 0, 20000, 40)
-FROM ontime WHERE Year = 2015 GROUP BY OriginCityName, DestCityName ORDER BY flights DESC LIMIT 20
-</pre>
-                    <img src="images/tutorial/a8518a200d6d405a95ee80ea1c8e1c90.png"/>
-<pre>
-SELECT
-    OriginCityName &lt; DestCityName ? OriginCityName : DestCityName AS a,
-    OriginCityName &lt; DestCityName ? DestCityName : OriginCityName AS b,
-    count(*) AS flights,
-    bar(flights, 0, 40000, 40)
-FROM ontime WHERE Year = 2015 GROUP BY a, b ORDER BY flights DESC LIMIT 20
-</pre>
-                    <img src="images/tutorial/d3578db55e304bd7b5eba818abdb53f5.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">the most popular cities of departure;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT OriginCityName, count(*) AS flights
-FROM ontime GROUP BY OriginCityName ORDER BY flights DESC LIMIT 20
-</pre>
-                    <img src="images/tutorial/ef4141f348234773a5349c4bd3e8f804.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">cities of departure which offer maximum variety of
-                destinations;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT OriginCityName, uniq(Dest) AS u
-FROM ontime GROUP BY OriginCityName ORDER BY u DESC LIMIT 20
-</pre>
-                    <img src="images/tutorial/2409f49d11fb4aa1b8b5ff34cf9ca75d.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">flight delay dependence on the day of week;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT DayOfWeek, count() AS c, avg(DepDelay &gt;  60) AS delays
-FROM ontime GROUP BY DayOfWeek ORDER BY DayOfWeek
-</pre>
-                    <img src="images/tutorial/885e507930e34b7c8f788d25e7ca2bcf.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">cities of departure with most frequent delays for 1 hour or
-                longer;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT OriginCityName, count() AS c, avg(DepDelay &gt;  60) AS delays
-FROM ontime
-GROUP BY OriginCityName
-HAVING c &gt;  100000
-ORDER BY delays DESC
-LIMIT 20
-</pre>
-                    <img src="images/tutorial/ac292656d03946d0aba35c75783a31f2.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">flights of maximum duration;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT OriginCityName, DestCityName, count(*) AS flights, avg(AirTime) AS duration
-FROM ontime
-GROUP BY OriginCityName, DestCityName
-ORDER BY duration DESC
-LIMIT 20
-</pre>
-                    <img src="images/tutorial/7b3c2e685832439b8c373bf2015131d2.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">distribution of arrival time delays split by aircompanies;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT Carrier, count() AS c, round(quantileTDigest(0.99)(DepDelay), 2) AS q
-FROM ontime GROUP BY Carrier ORDER BY q DESC
-</pre>
-                    <img src="images/tutorial/49c332e3d93146ba8f46beef6b2b02b0.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">aircompanies who stopped flights operation;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT Carrier, min(Year), max(Year), count()
-FROM ontime GROUP BY Carrier HAVING max(Year) &lt; 2015 ORDER BY count() DESC
-</pre>
-                    <img src="images/tutorial/24956f1a2efc48d78212586958aa036c.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">most trending destination cities in 2015;</a>
-                <div class="spoiler_body">
-<pre>
-SELECT
-    DestCityName,
-    sum(Year = 2014) AS c2014,
-    sum(Year = 2015) AS c2015,
-    c2015 / c2014 AS diff
-FROM ontime
-WHERE Year IN (2014, 2015)
-GROUP BY DestCityName
-HAVING c2014 &gt;  10000 AND c2015 &gt;  1000 AND diff &gt;  1
-ORDER BY diff DESC
-</pre>
-                    <img src="images/tutorial/f3132f4d1c0d42eab26d9111afe7771a.png"/></div>
-            </div>
-        </li>
-        <li>
-            <div class="spoiler"><a class="spoiler_title">destination cities with maximum popularity-season
-                dependency.</a>
-                <div class="spoiler_body">
-<pre>
-SELECT
-    DestCityName,
-    any(total),
-    avg(abs(monthly * 12 - total) / total) AS avg_month_diff
-FROM
-(
-    SELECT DestCityName, count() AS total
-    FROM ontime GROUP BY DestCityName HAVING total &gt; 100000
-)
-ALL INNER JOIN
-(
-    SELECT DestCityName, Month, count() AS monthly
-    FROM ontime GROUP BY DestCityName, Month HAVING monthly &gt; 10000
-)
-USING DestCityName
-GROUP BY DestCityName
-ORDER BY avg_month_diff DESC
-LIMIT 20
-</pre>
-                    <img src="images/tutorial/26b2c7aae21a4c76800cb1c7a33a374d.png"/></div>
-            </div>
-        </li>
-    </ul>
-
-    <h3>ClickHouse deployment to cluster</h3>
-    <p>ClickHouse cluster is a homogenous cluster. Steps to set up:
-    <ol>
-        <li>Install ClickHouse server on all machines of the cluster</li>
-        <li>Set up cluster configs in configuration file</li>
-        <li>Create local tables on each instance</li>
-        <li>Create a <a href="docs/en/table_engines/distributed/">Distributed table</a></li>
-    </ol>
-    </p>
-
-    <p><a href="docs/en/table_engines/distributed/">Distributed-table</a> is actually a kind of
-        "view" to local tables of ClickHouse cluster. SELECT query from a distributed table will be executed using
-        resources of all cluster's shards. You may specify configs for multiple clusters and create multiple
-        Distributed-tables providing views to different clusters.</p>
-
-    <div class="spoiler"><a class="spoiler_title">Config for cluster of three shards. Each shard stores data on a single
-        replica</a>
-        <div class="spoiler_body">
-<pre>
-&lt;remote_servers&gt;
-    &lt;perftest_3shards_1replicas&gt;
-        &lt;shard&gt;
-            &lt;replica&gt;
-                &lt;host&gt;example-perftest01j.yandex.ru&lt;/host&gt;
-                &lt;port&gt;9000&lt;/port&gt;
-            &lt;/replica&gt;
-        &lt;/shard&gt;
-        &lt;shard&gt;
-            &lt;replica&gt;
-                &lt;host&gt;example-perftest02j.yandex.ru&lt;/host&gt;
-                &lt;port&gt;9000&lt;/port&gt;
-            &lt;/replica&gt;
-        &lt;/shard&gt;
-        &lt;shard&gt;
-            &lt;replica&gt;
-                &lt;host&gt;example-perftest03j.yandex.ru&lt;/host&gt;
-                &lt;port&gt;9000&lt;/port&gt;
-            &lt;/replica&gt;
-        &lt;/shard&gt;
-    &lt;/perftest_3shards_1replicas&gt;
-&lt;/remote_servers&gt;
-</pre>
-        </div>
-    </div>
-    Creating a local table:
-    <pre>CREATE TABLE ontime_local (...) ENGINE = MergeTree(FlightDate, (Year, FlightDate), 8192);</pre>
-    Creating a distributed table providing a view into local tables of the cluster:
-<pre>CREATE TABLE ontime_all AS ontime_local
-    ENGINE = Distributed(perftest_3shards_1replicas, default, ontime_local, rand());</pre>
-
-    <p>You can create a Distributed table on all machines in the cluster. This would allow to run distributed queries on
-        any machine of the cluster. Besides distributed table you can also use <a
-                href="docs/en/table_functions/remote/">*remote* table function</a>.</p>
-
-    <p>Let's run <a href="docs/en/query_language/queries/#insert">INSERT SELECT</a> into Distributed table
-        to spread the table to multiple servers.</p>
-
-    <pre>INSERT INTO ontime_all SELECT * FROM ontime;</pre>
-
-    <p class="tip"><b>⚠</b> Worth to notice that the approach given above wouldn't fit for sharding of large
-        tables.</p>
-
-    <p>As you could expect heavy queries are executed N times faster being launched on 3 servers instead of one.</p>
-    <div class="spoiler"><a class="spoiler_title">See here</a>
-        <div class="spoiler_body">
-            <img src="images/tutorial/ece020129fdf4a18a6e75daf2e699cb9.png"/>
-
-            <p>You may have noticed that quantiles calculation are slightly different. This happens due to <a
-                    href="https://github.com/tdunning/t-digest/raw/master/docs/t-digest-paper/histo.pdf">t-digest</a>
-                algorithm implementation which is non-deterministic — it depends on the order of data processing.</p>
-        </div>
-    </div>
-
-    <p>In this case we have used a cluster with 3 shards each contains a single replica.</p>
-
-    <p>To provide for resilience in production environment we recommend that each shard should contain 2-3 replicas
-        distributed between multiple data-centers. Note that ClickHouse supports unlimited number of replicas.</p>
-
-    <div class="spoiler"><a class="spoiler_title">Config for cluster of one shard containing three replicas</a>
-        <div class="spoiler_body">
-<pre>
-&lt;remote_servers&gt;
-    ...
-    &lt;perftest_1shards_3replicas&gt;
-        &lt;shard&gt;
-            &lt;replica&gt;
-                &lt;host&gt;example-perftest01j.yandex.ru&lt;/host&gt;
-                &lt;port&gt;9000&lt;/port&gt;
-             &lt;/replica&gt;
-             &lt;replica&gt;
-                &lt;host&gt;example-perftest02j.yandex.ru&lt;/host&gt;
-                &lt;port&gt;9000&lt;/port&gt;
-             &lt;/replica&gt;
-             &lt;replica&gt;
-                &lt;host&gt;example-perftest03j.yandex.ru&lt;/host&gt;
-                &lt;port&gt;9000&lt;/port&gt;
-             &lt;/replica&gt;
-        &lt;/shard&gt;
-    &lt;/perftest_1shards_3replicas&gt;
-&lt;/remote_servers&gt;
-</pre>
-        </div>
-    </div>
-
-    <p>To enable replication <a href="http://zookeeper.apache.org/" rel="external nofollow">ZooKeeper</a> is required.
-        ClickHouse will take care of data consistency on all replicas and run restore procedure after failure
-        automatically. It's recommended to deploy ZooKeeper cluster to separate servers.</p>
-
-    <p>ZooKeeper is not a requirement — in some simple cases you can duplicate the data by writing it into all the
-        replicas from your application code. This approach is not recommended — in this case ClickHouse is not able to
-        guarantee data consistency on all replicas. This remains the responsibility of your application.</p>
-
-    <div class="spoiler"><a class="spoiler_title">Set ZooKeeper locations in configuration file</a>
-        <div class="spoiler_body">
-<pre>
-&lt;zookeeper&gt;
-    &lt;node&gt;
-        &lt;host&gt;zoo01.yandex.ru&lt;/host&gt;
-        &lt;port&gt;2181&lt;/port&gt;
-    &lt;/node&gt;
-    &lt;node&gt;
-        &lt;host&gt;zoo02.yandex.ru&lt;/host&gt;
-        &lt;port&gt;2181&lt;/port&gt;
-    &lt;/node&gt;
-    &lt;node&gt;
-        &lt;host&gt;zoo03.yandex.ru&lt;/host&gt;
-        &lt;port&gt;2181&lt;/port&gt;
-    &lt;/node&gt;
-&lt;/zookeeper&gt;
-</pre>
-        </div>
-    </div>
-
-    <p>Also we need to set macros for identifying shard and replica — it will be used on table creation</p>
-<pre>
-&lt;macros&gt;
-    &lt;shard&gt;01&lt;/shard&gt;
-    &lt;replica&gt;01&lt;/replica&gt;
-&lt;/macros&gt;
-</pre>
-    <p>If there are no replicas at the moment on replicated table creation — a new first replica will be instantiated.
-        If there are already live replicas — new replica will clone the data from existing ones. You have an option to
-        create all replicated tables first and that insert data to it. Another option is to create some replicas and add
-        the others after or during data insertion.</p>
-
-<pre>
-CREATE TABLE ontime_replica (...)
-ENGINE = ReplicatedMergeTree(
-    '/clickhouse_perftest/tables/{shard}/ontime',
-    '{replica}',
-    FlightDate,
-    (Year, FlightDate),
-    8192);
-</pre>
-    <p>Here we use <a href="docs/en/table_engines/replication/#replicatedmergetree">ReplicatedMergeTree</a>
-        table type. In parameters we specify ZooKeeper path containing shard and replica identifiers.</p>
-
-    <pre>INSERT INTO ontime_replica SELECT * FROM ontime;</pre>
-    <p>Replication operates in multi-master mode. Data can be loaded into any replica — it will be synced with other
-        instances automatically. Replication is asynchronous so at a given moment of time not all replicas may contain
-        recently inserted data. To allow data insertion at least one replica should be up. Others will sync up data and
-        repair consistency once they will become active again. Please notice that such scheme allows for the possibility
-        of just appended data loss.</p>
-
-    <p class="warranty"><a href="https://github.com/ClickHouse/ClickHouse/blob/master/LICENSE"
-                           rel="external nofollow" target="_blank">
-        ClickHouse source code is published under Apache 2.0 License.</a> Software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-        KIND, either express or implied.</p>
-
-    <p id="footer">&copy; 2016–2019 <a href="https://yandex.com/company/" rel="external nofollow">YANDEX</a> LLC</p>
-
-</div>
-
-<script type="text/javascript" src="https://yastatic.net/jquery/3.1.1/jquery.min.js"></script>
-<script type="text/javascript">
-    $('.spoiler_title').click(function () {
-        $(this).next('.spoiler_body').toggle(100);
-    });
-
-    var name = document.getElementById('main_title').textContent.trim().toLowerCase();
-    var feedback_address = name + '-feedback' + '@yandex-team.com';
-    var feedback_email = document.getElementById('feedback_email');
-    feedback_email.setAttribute('href', 'mailto:' + feedback_address);
-    feedback_email.textContent = feedback_address;
-</script>
-<!-- Yandex.Metrika counter -->
-<script type="text/javascript">
-    (function (d, w, c) {
-        (w[c] = w[c] || []).push(function() {
-            try {
-                w.yaCounter18343495 = new Ya.Metrika2({
-                    id:18343495,
-                    clickmap:true,
-                    trackLinks:true,
-                    accurateTrackBounce:true,
-                    webvisor:true
-                });
-            } catch(e) { }
-        });
-
-        var n = d.getElementsByTagName("script")[0],
-            s = d.createElement("script"),
-            f = function () { n.parentNode.insertBefore(s, n); };
-        s.type = "text/javascript";
-        s.async = true;
-        s.src = "https://mc.yandex.ru/metrika/tag.js";
-
-        if (w.opera == "[object Opera]") {
-            d.addEventListener("DOMContentLoaded", f, false);
-        } else { f(); }
-    })(document, window, "yandex_metrika_callbacks2");
-</script>
-<noscript>
-    <div><img src="https://mc.yandex.ru/watch/18343495" style="position:absolute; left:-9999px;" alt=""/></div>
-</noscript>
-<!-- /Yandex.Metrika counter -->
-
-
-</body>
-</html>