Skip to content

Commit

Permalink
Domain change in docs
Browse files Browse the repository at this point in the history
  • Loading branch information
blinkov committed Jan 30, 2020
1 parent 223704e commit 18538f5
Show file tree
Hide file tree
Showing 509 changed files with 588 additions and 586 deletions.
6 changes: 4 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,14 @@
/build_*
/build-*
/docs/build
/docs/publish
/docs/edit
/docs/tools/venv/
/docs/en/development/build/
/docs/ru/development/build/
/docs/en/single.md
/docs/ru/single.md
/docs/zh/single.md
/docs/ja/single.md
/docs/fa/single.md

# callgrind files
callgrind.out.*
Expand Down
6 changes: 3 additions & 3 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Writing the docs is extremely useful for project's users and developers, and gro

The documentation contains information about all the aspects of the ClickHouse lifecycle: developing, testing, installing, operating, and using. The base language of the documentation is English. The English version is the most actual. All other languages are supported as much as they can by contributors from different countries.

At the moment, [documentation](https://clickhouse.yandex/docs) exists in English, Russian, Chinese, Japanese, and Farsi. We store the documentation besides the ClickHouse source code in the [GitHub repository](https://github.com/ClickHouse/ClickHouse/tree/master/docs).
At the moment, [documentation](https://clickhouse.tech/docs) exists in English, Russian, Chinese, Japanese, and Farsi. We store the documentation besides the ClickHouse source code in the [GitHub repository](https://github.com/ClickHouse/ClickHouse/tree/master/docs).

Each language lays in the corresponding folder. Files that are not translated from English are the symbolic links to the English ones.

Expand All @@ -54,7 +54,7 @@ You can contribute to the documentation in many ways, for example:

- Open a required file in the ClickHouse repository and edit it from the GitHub web interface.

You can do it on GitHub, or on the [ClickHouse Documentation](https://clickhouse.yandex/docs/en/) site. Each page of ClickHouse Documentation site contains an "Edit this page" (🖋) element in the upper right corner. Clicking this symbol, you get to the ClickHouse docs file opened for editing.
You can do it on GitHub, or on the [ClickHouse Documentation](https://clickhouse.tech/docs/en/) site. Each page of ClickHouse Documentation site contains an "Edit this page" (🖋) element in the upper right corner. Clicking this symbol, you get to the ClickHouse docs file opened for editing.

When you are saving a file, GitHub opens a pull-request for your contribution. Add the `documentation` label to this pull request for proper automatic checks applying. If you have no permissions for adding labels, the reviewer of your PR adds it.

Expand Down Expand Up @@ -161,7 +161,7 @@ When writing documentation, think about people who read it. Each audience has sp
ClickHouse documentation can be divided by the audience for the following parts:
- Conceptual topics in [Introduction](https://clickhouse.yandex/docs/en/), tutorials and overviews, changelog.
- Conceptual topics in [Introduction](https://clickhouse.tech/docs/en/), tutorials and overviews, changelog.
These topics are for the most common auditory. When editing text in them, use the most common terms that are comfortable for the audience with basic technical skills.
Expand Down
2 changes: 1 addition & 1 deletion docs/en/data_types/array.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,4 +66,4 @@ Code: 386. DB::Exception: Received from localhost:9000, 127.0.0.1. DB::Exception
```


[Original article](https://clickhouse.yandex/docs/en/data_types/array/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/array/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/boolean.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@
There isn't a separate type for boolean values. They use the UInt8 type, restricted to the values 0 or 1.


[Original article](https://clickhouse.yandex/docs/en/data_types/boolean/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/boolean/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/date.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@ The minimum value is output as 0000-00-00.
The date is stored without the time zone.


[Original article](https://clickhouse.yandex/docs/en/data_types/date/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/date/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/datetime.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,4 +87,4 @@ SELECT toDateTime(now(), 'Europe/Moscow') AS column, toTypeName(column) AS x
- [Operators for working with dates and times](../query_language/operators.md#operators-datetime)
- [The `Date` data type](date.md)

[Original article](https://clickhouse.yandex/docs/en/data_types/datetime/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/datetime/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/decimal.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,4 +95,4 @@ SELECT toDecimal32(1, 8) < 100
DB::Exception: Can't compare.
```

[Original article](https://clickhouse.yandex/docs/en/data_types/decimal/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/decimal/) <!--hide-->
8 changes: 4 additions & 4 deletions docs/en/data_types/domains/ipv4.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,16 +26,16 @@ CREATE TABLE hits (url String, from IPv4) ENGINE = MergeTree() ORDER BY from;
`IPv4` domain supports custom input format as IPv4-strings:

```sql
INSERT INTO hits (url, from) VALUES ('https://wikipedia.org', '116.253.40.133')('https://clickhouse.yandex', '183.247.232.58')('https://clickhouse.yandex/docs/en/', '116.106.34.242');
INSERT INTO hits (url, from) VALUES ('https://wikipedia.org', '116.253.40.133')('https://clickhouse.tech', '183.247.232.58')('https://clickhouse.yandex/docs/en/', '116.106.34.242');

SELECT * FROM hits;
```

```text
┌─url────────────────────────────────┬───────────from─┐
│ https://clickhouse.yandex/docs/en/ │ 116.106.34.242 │
│ https://clickhouse.tech/docs/en/ │ 116.106.34.242 │
│ https://wikipedia.org │ 116.253.40.133 │
│ https://clickhouse.yandex │ 183.247.232.58 │
│ https://clickhouse.tech │ 183.247.232.58 │
└────────────────────────────────────┴────────────────┘
```

Expand Down Expand Up @@ -76,4 +76,4 @@ SELECT toTypeName(i), CAST(from as UInt32) as i FROM hits LIMIT 1;
└──────────────────────────────────┴────────────┘
```

[Original article](https://clickhouse.yandex/docs/en/data_types/domains/ipv4) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/domains/ipv4) <!--hide-->
8 changes: 4 additions & 4 deletions docs/en/data_types/domains/ipv6.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,15 @@ CREATE TABLE hits (url String, from IPv6) ENGINE = MergeTree() ORDER BY from;
`IPv6` domain supports custom input as IPv6-strings:

```sql
INSERT INTO hits (url, from) VALUES ('https://wikipedia.org', '2a02:aa08:e000:3100::2')('https://clickhouse.yandex', '2001:44c8:129:2632:33:0:252:2')('https://clickhouse.yandex/docs/en/', '2a02:e980:1e::1');
INSERT INTO hits (url, from) VALUES ('https://wikipedia.org', '2a02:aa08:e000:3100::2')('https://clickhouse.tech', '2001:44c8:129:2632:33:0:252:2')('https://clickhouse.yandex/docs/en/', '2a02:e980:1e::1');

SELECT * FROM hits;
```

```text
┌─url────────────────────────────────┬─from──────────────────────────┐
│ https://clickhouse.yandex │ 2001:44c8:129:2632:33:0:252:2 │
│ https://clickhouse.yandex/docs/en/ │ 2a02:e980:1e::1 │
│ https://clickhouse.tech │ 2001:44c8:129:2632:33:0:252:2 │
│ https://clickhouse.tech/docs/en/ │ 2a02:e980:1e::1 │
│ https://wikipedia.org │ 2a02:aa08:e000:3100::2 │
└────────────────────────────────────┴───────────────────────────────┘
```
Expand Down Expand Up @@ -76,4 +76,4 @@ SELECT toTypeName(i), CAST(from as FixedString(16)) as i FROM hits LIMIT 1;
└───────────────────────────────────────────┴─────────┘
```

[Original article](https://clickhouse.yandex/docs/en/data_types/domains/ipv6) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/domains/ipv6) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/domains/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,4 +23,4 @@ You can use domains anywhere corresponding base type can be used:
* Can't implicitly convert string values into domain values when inserting data from another column or table.
* Domain adds no constrains on stored values.

[Original article](https://clickhouse.yandex/docs/en/data_types/domains/overview) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/domains/overview) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/enum.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,4 +117,4 @@ The Enum type can be changed without cost using ALTER, if only the set of values
Using ALTER, it is possible to change an Enum8 to an Enum16 or vice versa, just like changing an Int8 to Int16.


[Original article](https://clickhouse.yandex/docs/en/data_types/enum/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/enum/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/fixedstring.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,4 +52,4 @@ This behavior differs from MySQL behavior for the `CHAR` type (where strings are

Note that the length of the `FixedString(N)` value is constant. The [length](../query_language/functions/array_functions.md#array_functions-length) function returns `N` even if the `FixedString(N)` value is filled only with null bytes, but the [empty](../query_language/functions/string_functions.md#string_functions-empty) function returns `1` in this case.

[Original article](https://clickhouse.yandex/docs/en/data_types/fixedstring/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/fixedstring/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/float.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,4 +70,4 @@ SELECT 0 / 0
See the rules for `NaN` sorting in the section [ORDER BY clause](../query_language/select.md).


[Original article](https://clickhouse.yandex/docs/en/data_types/float/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/float/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ ClickHouse can store various types of data in table cells.
This section describes the supported data types and special considerations when using and/or implementing them, if any.


[Original article](https://clickhouse.yandex/docs/en/data_types/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/int_uint.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,4 @@ Fixed-length integers, with or without a sign.
- UInt64 - [0 : 18446744073709551615]


[Original article](https://clickhouse.yandex/docs/en/data_types/int_uint/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/int_uint/) <!--hide-->
Original file line number Diff line number Diff line change
Expand Up @@ -61,4 +61,4 @@ SELECT uniqMerge(state) FROM (SELECT uniqState(UserID) AS state FROM table GROUP
See [AggregatingMergeTree](../../operations/table_engines/aggregatingmergetree.md) engine description.


[Original article](https://clickhouse.yandex/docs/en/data_types/nested_data_structures/aggregatefunction/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/nested_data_structures/aggregatefunction/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/nested_data_structures/index.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Nested Data Structures


[Original article](https://clickhouse.yandex/docs/en/data_types/nested_data_structures/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/nested_data_structures/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/nested_data_structures/nested.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,4 +97,4 @@ For a DESCRIBE query, the columns in a nested data structure are listed separate
The ALTER query is very limited for elements in a nested data structure.


[Original article](https://clickhouse.yandex/docs/en/data_types/nested_data_structures/nested/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/nested_data_structures/nested/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/nullable.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,4 +33,4 @@ SELECT x + y FROM t_null
└────────────┘
```

[Original article](https://clickhouse.yandex/docs/en/data_types/nullable/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/nullable/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/special_data_types/expression.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@
Used for representing lambda expressions in high-order functions.


[Original article](https://clickhouse.yandex/docs/en/data_types/special_data_types/expression/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/special_data_types/expression/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/special_data_types/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@
Special data type values can't be saved to a table or output in results, but are used as the intermediate result of running a query.


[Original article](https://clickhouse.yandex/docs/en/data_types/special_data_types/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/special_data_types/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/special_data_types/nothing.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,4 @@ SELECT toTypeName(array())
```


[Original article](https://clickhouse.yandex/docs/en/data_types/special_data_types/nothing/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/special_data_types/nothing/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/special_data_types/set.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@
Used for the right half of an IN expression.


[Original article](https://clickhouse.yandex/docs/en/data_types/special_data_types/set/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/special_data_types/set/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/string.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,4 @@ Similarly, certain functions for working with strings have separate variations t
For example, the 'length' function calculates the string length in bytes, while the 'lengthUTF8' function calculates the string length in Unicode code points, assuming that the value is UTF-8 encoded.


[Original article](https://clickhouse.yandex/docs/en/data_types/string/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/string/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/tuple.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,4 @@ SELECT tuple(1, NULL) AS x, toTypeName(x)
```


[Original article](https://clickhouse.yandex/docs/en/data_types/tuple/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/tuple/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/data_types/uuid.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,4 +62,4 @@ The UUID data type only supports functions which [String](string.md) data type a

The UUID data type is not supported by arithmetic operations (for example, [abs](../query_language/functions/arithmetic_functions.md#arithm_func-abs)) or aggregate functions, such as [sum](../query_language/agg_functions/reference.md#agg_function-sum) and [avg](../query_language/agg_functions/reference.md#agg_function-avg).

[Original article](https://clickhouse.yandex/docs/en/data_types/uuid/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/data_types/uuid/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/database_engines/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ You can also use the following database engines:

- [Lazy](lazy.md)

[Original article](https://clickhouse.yandex/docs/en/database_engines/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/database_engines/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/database_engines/lazy.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ It's optimized for storing many small \*Log tables, for which there is a long ti
CREATE DATABASE testlazy ENGINE = Lazy(expiration_time_in_seconds);
```

[Original article](https://clickhouse.yandex/docs/en/database_engines/lazy/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/database_engines/lazy/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/database_engines/mysql.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,4 +119,4 @@ SELECT * FROM mysql_db.mysql_table
└────────┴───────┘
```

[Original article](https://clickhouse.yandex/docs/en/database_engines/mysql/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/database_engines/mysql/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/development/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,4 +194,4 @@ In addition, each replica stores its state in ZooKeeper as the set of parts and
> The ClickHouse cluster consists of independent shards, and each shard consists of replicas. The cluster is not elastic, so after adding a new shard, data is not rebalanced between shards automatically. Instead, the cluster load will be uneven. This implementation gives you more control, and it is fine for relatively small clusters such as tens of nodes. But for clusters with hundreds of nodes that we are using in production, this approach becomes a significant drawback. We should implement a table engine that will span its data across the cluster with dynamically replicated regions that could be split and balanced between clusters automatically.

[Original article](https://clickhouse.yandex/docs/en/development/architecture/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/development/architecture/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/development/build.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,4 +83,4 @@ To create an executable, run `ninja clickhouse`.
This will create the `dbms/programs/clickhouse` executable, which can be used with `client` or `server` arguments.


[Original article](https://clickhouse.yandex/docs/en/development/build/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/development/build/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/development/build_cross_osx.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# How to Build ClickHouse on Linux for Mac OS X

This is for the case when you have Linux machine and want to use it to build `clickhouse` binary that will run on OS X. This is intended for continuous integration checks that run on Linux servers. If you want to build ClickHouse directly on Mac OS X, then proceed with another instruction: https://clickhouse.yandex/docs/en/development/build_osx/
This is for the case when you have Linux machine and want to use it to build `clickhouse` binary that will run on OS X. This is intended for continuous integration checks that run on Linux servers. If you want to build ClickHouse directly on Mac OS X, then proceed with another instruction: https://clickhouse.tech/docs/en/development/build_osx/

The cross-build for Mac OS X is based on the [Build instructions](build.md), follow them first.

Expand Down
2 changes: 1 addition & 1 deletion docs/en/development/build_osx.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,4 +82,4 @@ Reboot.
To check if it's working, you can use `ulimit -n` command.


[Original article](https://clickhouse.yandex/docs/en/development/build_osx/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/development/build_osx/) <!--hide-->
8 changes: 4 additions & 4 deletions docs/en/development/developer_instruction.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,7 @@ Official Yandex builds currently use GCC because it generates machine code of sl

To install GCC on Ubuntu run: `sudo apt install gcc g++`

Check the version of gcc: `gcc --version`. If it is below 9, then follow the instruction here: https://clickhouse.yandex/docs/en/development/build/#install-gcc-9.
Check the version of gcc: `gcc --version`. If it is below 9, then follow the instruction here: https://clickhouse.tech/docs/en/development/build/#install-gcc-9.

Mac OS X build is supported only for Clang. Just run `brew install llvm`

Expand Down Expand Up @@ -226,11 +226,11 @@ Just in case, it is worth mentioning that CLion creates `build` path on its own,

# Writing Code

The description of ClickHouse architecture can be found here: https://clickhouse.yandex/docs/en/development/architecture/
The description of ClickHouse architecture can be found here: https://clickhouse.tech/docs/en/development/architecture/

The Code Style Guide: https://clickhouse.yandex/docs/en/development/style/
The Code Style Guide: https://clickhouse.tech/docs/en/development/style/

Writing tests: https://clickhouse.yandex/docs/en/development/tests/
Writing tests: https://clickhouse.tech/docs/en/development/tests/

List of tasks: https://github.com/yandex/ClickHouse/blob/master/dbms/tests/instructions/easy_tasks_sorted_en.md

Expand Down
2 changes: 1 addition & 1 deletion docs/en/development/index.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# ClickHouse Development


[Original article](https://clickhouse.yandex/docs/en/development/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/development/) <!--hide-->
2 changes: 1 addition & 1 deletion docs/en/development/style.md
Original file line number Diff line number Diff line change
Expand Up @@ -835,4 +835,4 @@ function(
size_t limit)
```

[Original article](https://clickhouse.yandex/docs/en/development/style/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/development/style/) <!--hide-->
4 changes: 2 additions & 2 deletions docs/en/development/tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -226,7 +226,7 @@ If you use `CLion` as an IDE, you can leverage some `clang-tidy` checks out of t

## Code Style

Code style rules are described [here](https://clickhouse.yandex/docs/en/development/style/).
Code style rules are described [here](https://clickhouse.tech/docs/en/development/style/).

To check for some common style violations, you can use `utils/check-style` script.

Expand Down Expand Up @@ -258,4 +258,4 @@ Build jobs and tests are run in Sandbox on per commit basis. Resulting packages
We don't use Travis CI due to the limit on time and computational power.
We don't use Jenkins. It was used before and now we are happy we are not using Jenkins.

[Original article](https://clickhouse.yandex/docs/en/development/tests/) <!--hide-->
[Original article](https://clickhouse.tech/docs/en/development/tests/) <!--hide-->
Loading

0 comments on commit 18538f5

Please sign in to comment.