Skip to content

Commit 7a161b5

Browse files
committed
@aaabramov's suggestions
Co-authored-by: Andrii Abramov <aabrasha@gmail.com>
1 parent 2301538 commit 7a161b5

File tree

3 files changed

+7
-7
lines changed

3 files changed

+7
-7
lines changed

_uk/scala3/contribute-to-docs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ scala3: true
77
---
88

99
## Огляд
10-
Існує кілька напрямів зусиль для створення високоякісної документації для Scala 3.
10+
Існує декілька напрямів зусиль для створення високоякісної документації для Scala 3.
1111
Зокрема, є такі документи:
1212

1313
- Книга Scala 3

_uk/scala3/guides/tasty-overview.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ hello.tasty
3434

3535
## Що таке TASTy?
3636

37-
TASTy це акронім терміну, _ Абстрактне синтаксичне дерево типів (Typed Abstract Syntax Trees)_.
37+
TASTy це акронім терміну, _Абстрактне синтаксичне дерево типів (Typed Abstract Syntax Trees)_.
3838
Це високорівневий формат для Scala 3, і в цьому документі ми називатимемо його як _Tasty_.
3939

4040
Перше, що важливо знати, це те, що файли Tasty генеруються компілятором `scalac`,
@@ -68,13 +68,13 @@ $ scalac -decompile hello.tasty
6868
Через проблему [стирання типів][erasure], файли _.class_ містять неповне представлення про ваш код.
6969
Простий спосіб продемонструвати це приклад з `List`.
7070

71-
_Стирання типів_ означає, що коли ви пишете наступний код Scala, він повинен працювати на JVM:
71+
_Стирання типів_ означає, що коли ви пишете наступний код Scala:
7272

7373
```scala
7474
val xs: List[Int] = List(1, 2, 3)
7575
```
7676

77-
цей код компілюється у файл _.class_, який має бути сумісним із JVM. Результатом цієї вимоги сумісності код всередині цього файлу класу --- який ви можете побачити за допомогою команди `javap` --- виглядає так:
77+
цей код компілюється у файл _.class_, який має бути сумісним із JVM. Результатом цієї вимоги сумісності код всередині цього файлу класу який ви можете побачити за допомогою команди `javap` виглядає так:
7878

7979
```java
8080
public scala.collection.immutable.List<java.lang.Object> xs();
@@ -95,7 +95,7 @@ int x = (Int) xs.get(0) // Java-подібно
9595
val x = xs.get(0).asInstanceOf[Int] // більш Scala-подібно
9696
```
9797

98-
Знову ж таки, це зроблено для сумісності, щоб ваш код Scala міг працювати на JVMю
98+
Знову ж таки, це зроблено для сумісності, щоб ваш код Scala міг працювати на JVM.
9999
Однак, інформація про те, що ми вже мали список цілих чисел, втрачається у файлах класу.
100100
Це створює проблеми під час спроби збірки Scala програми з уже скомпільованою бібліотекою.
101101
Для цього нам потрібно більше інформації, ніж зазвичай міститься у файлах класу.
@@ -115,7 +115,7 @@ val x = xs.get(0).asInstanceOf[Int] // більш Scala-подібно
115115

116116
- Під **час компіляції**, `scalac` читає та аналізує ваш код, він знає, що `xs` є `List[Int]`
117117
- Коли компілятор записує ваш код у файл класу, він записує `xs` як `List[Object]`, та додає інформацію про перетворення усюди, де йде звернення до `xs`
118-
- Потім під **час виконання** --- коли ваш код працює в JVM --- JVM не знає, що ваш список є `List[Int]`
118+
- Потім під **час виконання** коли ваш код працює в JVM JVM не знає, що ваш список є `List[Int]`
119119

120120
Зі Scala 3 та Tasty, є ще одна важлива примітка про час компіляції:
121121

_uk/scala3/scaladoc.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Scaladoc також забезпечує простий спосіб створ
5151
Одним з експериментальних особливостей Scaladoc є компілятор фрагментів (snippets compiler).
5252
Цей інструмент дозволить вам компілювати фрагменти, які ви додаєте до docstring, щоб перевірити, чи вони насправді поводяться належним чином.
5353
Ця функція дуже схожа на інструменти `tut` або `mdoc`, але буде поставлятися разом із Scaladoc для легкого налаштування та інтеграції у ваш проєкт.
54-
Зробити фрагменти інтерактивними --- наприклад, дозволити користувачам редагувати та компілювати їх у браузері --- наразі розглядається.
54+
Зробити фрагменти інтерактивними, наприклад, дозволити користувачам редагувати та компілювати їх у браузері, наразі розглядається.
5555

5656
Вітрина:
5757
* Приховування коду ![]({{ site.baseurl }}/resources/images/scala3/scaladoc/hiding-code.gif)

0 commit comments

Comments
 (0)