Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

🇺🇦 Ukrainian localization of OpenTelemetry documentation #5891

Open
wants to merge 23 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
d3f85ed
Add Ukrainian localization and documentation for OpenTelemetry
Andygol Dec 26, 2024
707db47
Add Ukrainian announcements and developer experience survey content
Andygol Dec 26, 2024
70b78ef
Add Ukrainian community resources and feedback channels for OpenTelem…
Andygol Dec 26, 2024
be3d0fd
Add Ukrainian site information page
Andygol Dec 26, 2024
f43749b
Add Ukrainian ecosystem documentation for OpenTelemetry
Andygol Dec 26, 2024
e41739d
Add Ukrainian documentation for OpenTelemetry overview and Getting st…
Andygol Dec 26, 2024
f378a28
Add Ukrainian documentation for OpenTelemetry concepts
Andygol Dec 26, 2024
89982ad
Add Ukrainian documentation for demo
Andygol Dec 26, 2024
fb360b0
Add Ukrainian documentation for various languages
Andygol Dec 26, 2024
b74c58e
Add Ukrainian documentation for zero-code instrumentation
Andygol Dec 26, 2024
a596675
Add Ukrainian documentation for OpenTelemetry Collector components
Andygol Dec 26, 2024
75361a2
Add Ukrainian documentation for OpenTelemetry Operator and related co…
Andygol Dec 26, 2024
bfe7541
Add Ukrainian documentation for Functions as a Service (FaaS) and Lam…
Andygol Dec 26, 2024
418180a
Add Ukrainian migration documentation for OpenTelemetry from OpenTrac…
Andygol Dec 26, 2024
a84fb06
Add Ukrainian documentation for specifications and status of OpenTele…
Andygol Dec 26, 2024
183b77d
Add Ukrainian documentation for security best practices, CVEs, and in…
Andygol Dec 26, 2024
d52413f
Add Ukrainian blog post on sunsetting OpenCensus and create blog index
Andygol Dec 26, 2024
2de71ae
Merge branch 'main' into main-uk
Andygol Dec 26, 2024
495501e
[uk] Add configuration instructions for php.ini in PHP SDK documentation
Andygol Dec 26, 2024
c5fdb10
Update OpenCensus migration redirect link to include Ukrainian path
Andygol Dec 26, 2024
8475e73
Update Ukrainian documentation for OpenTelemetry to improve clarity a…
Andygol Dec 26, 2024
e0a0f65
Add Ukrainian ecosystem documentation and update shortcode references
Andygol Dec 27, 2024
1e195ef
Add blog post on multilingual OpenTelemetry website
Andygol Dec 27, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
91 changes: 91 additions & 0 deletions content/uk/_index.md
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As suggested on slack, please follow the process to establish a localization group for Ukrainian: https://opentelemetry.io/docs/contributing/localization/#new-localizations. The first language PR should only contain this page.

Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: OpenTelemetry
description: >-
Високоякісна, повсюдна і переносна телеметрія для забезпечення ефективного спостереження
outputs:
- HTML
- REDIRECTS # Include this `content/en` ONLY
developer_note:
The blocks/cover shortcode (used below) will use as a background image any
image file containing "background" in its name.
show_banner: true
---

<div class="d-none"><a rel="me" href="https://fosstodon.org/@opentelemetry"></a></div>

{{< blocks/cover image_anchor="top" height="max" color="primary" >}}

<!-- prettier-ignore -->
![OpenTelemetry](/img/logos/opentelemetry-horizontal-color.svg)
{.otel-logo}

<!-- prettier-ignore -->
{{% param description %}}
{.display-6}

<div class="l-primary-buttons mt-5">

- [Дізнатися більше](docs/what-is-opentelemetry/)
- [Демонстрація](docs/demo/)

</div>

<div class="h3 mt-4">
<a class="text-secondary" href="docs/getting-started/">Розпочніть</a> в залежності від вашрої ролі
</div>
<div class="l-get-started-buttons">

- [Dev](docs/getting-started/dev/)
- [Ops](docs/getting-started/ops/)

</div>
{{< /blocks/cover >}}

{{% blocks/lead color="white" %}}

OpenTelemetry — це набір API, SDK та інструментів. Використовуйте цей набір для вимірювання, генерування, збору та експорту телеметричних даних (метрик, журналів і трейсів), які допоможуть вам аналізувати продуктивність та поведінку вашого програмного забезпечення.

> OpenTelemetry є [загально доступною](/status/) для [декількох мов програмування](docs/languages/) та годиться для промислового використання.

{{% /blocks/lead %}}

{{% blocks/section color="dark" type="row" %}}

{{% blocks/feature icon="fas fa-chart-line" title="Трейси, Метрики та Логи" url="docs/concepts/observability-primer/" %}}

Створюйте та збирайте телеметричні дані з ваших сервісів та програмного забезпечення, а потім надсилайте їх до різноманітних інструментів аналізу.

{{% /blocks/feature %}}

{{% blocks/feature icon="fas fa-magic" title="Інструментарій та інтеграція" %}}

OpenTelemetry [інтегрується][integrates] з багатьма популярними бібліотеками та фреймворками, а також підтримує [інструментарій][instrumentation] _на основі коду та без коду_.

[instrumentation]: /docs/concepts/instrumentation/
[integrates]: /ecosystem/integrations/

{{% /blocks/feature %}}

{{% blocks/feature icon="fab fa-github" title="Відкритий код, нейтральний до постачальників" %}}

OpenTelemetry — це на 100% відкритий та вільний код, який [підтримується та використовується][adopted] провідними [лідерами галузі][industry leaders] у сфері спостереження.

[adopted]: /ecosystem/adopters/
[industry leaders]: /ecosystem/vendors/

{{% /blocks/feature %}}

{{% /blocks/section %}}

{{% blocks/section color="secondary" type="cncf" %}}

**OpenTelemetry є проєктом, яким [опікується][incubating] [CNCF][]**.<br>
Утворений шляхом злиття проєктів OpenTracing та OpenCensus.

[![CNCF logo][]][cncf]

[cncf]: https://cncf.io
[cncf logo]: /img/logos/cncf-white.svg
[incubating]: https://www.cncf.io/projects/

{{% /blocks/section %}}
5 changes: 5 additions & 0 deletions content/uk/announcements/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Анонси
cascade:
type: docs
---
10 changes: 10 additions & 0 deletions content/uk/announcements/devex-survey.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: Опитування щодо досвіду розробника
date: 2024-12-16
expiryDate: 2025-01-31
---

<i class="fas fa-bullhorn"></i> Допоможіть нам [покращити досвід розробників] (5-10 хв). Опитування закривається 31 січня.

[покращити досвід розробників]:
https://docs.google.com/forms/d/1orPz5ayzosFrgYRm3-y90UMrt2ZjvIBKMDL_a2E3Fq8/viewform
8 changes: 8 additions & 0 deletions content/uk/api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: Документація API
linkTitle: API
redirect: /docs/languages/#api-references
manualLinkTarget: _blank
_build: { render: link }
aliases: [api-docs]
---
58 changes: 58 additions & 0 deletions content/uk/blog/2023/sunsetting-opencensus.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: Завершення підтримки OpenCensus
linkTitle: Завершення підтримки OpenCensus
date: 2023-05-01
author: '[Aaron Abbott](https://github.com/aabmass) (Google)'
cSpell:ignore: sunsetting
---

У 2019 році ми оголосили, що OpenTracing та OpenCensus обʼєднаються, щоб створити проєкт OpenTelemetry. З самого початку ми вважали OpenTelemetry [наступною основною версією як OpenTracing, так і OpenCensus](https://www.cncf.io/blog/2019/05/21/a-brief-history-of-opentelemetry-so-far/).

Ми раді оголосити, що OpenTelemetry досяг функціональної відповідності з OpenCensus у C++, .NET, Go, Java, JavaScript, PHP та Python. [Стабільні релізи](/docs/languages/#status-and-releases) як SDK для трасування, так і метрик доступні для більшості з цих мов, з Go та PHP незабаром. Це означає, що OpenTelemetry може збирати та експортувати телеметричні дані з тим самим рівнем функціональності, що й OpenCensus. Крім того, OpenTelemetry пропонує [багатшу екосистему](/ecosystem/) бібліотек інструментування та експортерів, та [активну спільноту з відкритим кодом](https://www.cncf.io/blog/2023/01/11/a-look-at-the-2022-velocity-of-cncf-linux-foundation-and-top-30-open-source-projects/).

Як результат, ми архівуємо всі репозиторії OpenCensus на GitHub (за винятком [census-instrumentation/opencensus-python][][^python-timeline]) 31 липня 2023 року. Ми раді бачити [довгостроковий план для OpenTelemetry](https://medium.com/opentracing/a-roadmap-to-convergence-b074e5815289) втілюється в життя, і закликаємо всіх користувачів OpenCensus перейти на OpenTelemetry.

## Як перейти на OpenTelemetry {#how-to-migrate-to-opentelemetry}

Однією з [ключових цілей](https://medium.com/opentracing/merging-opentracing-and-opencensus-f0fe9c7ca6f0) проєкту OpenTelemetry є забезпечення зворотної сумісності з OpenCensus та історії міграції для наявних користувачів.

Щоб полегшити шлях міграції, ми надаємо мости зворотної сумісності для наступних мов[^shim-next-release]:

- [Go][go shim]
- [Java][java shim]
- [JavaScript][js shim]
- [Python][python shim]

Встановлення цих мостів дозволяє інструментам OpenCensus та OpenTelemetry гладко взаємодіяти, з усією вашою телеметрією, що виходить через експортери OpenTelemetry. Це дозволяє користувачам OpenCensus поступово переводити всі свої інструменти з OpenCensus на OpenTelemetry, і нарешті видалити бібліотеки OpenCensus зі своїх застосунків[^shim-support].

Хоча OpenTelemetry ніколи не призначався бути суворою надмножиною OpenCensus, більшість API та моделей даних сумісні. Міграція повинна розглядатися як "основне оновлення версії", і ви можете помітити деякі зміни у вашій телеметрії.

Більше деталей про те, чого очікувати та деякі запропоновані робочі процеси для міграції
описані в [специфікації сумісності OpenCensus](/docs/specs/otel/compatibility/opencensus#migration-path).

## Чого очікувати після 31 липня 2023 року {#what-to-expect-after-july-31-2023}

Після 31 липня 2023 року проєкт OpenCensus більше не буде підтримуватися. Це означає, що нові функції не будуть додаватися до проєкту, і будь-які виявлені вразливості безпеки не будуть виправлені.

Однак, репозиторії OpenCensus залишаться архівованими на GitHub. Це означає, що користувачі все ще зможуть завантажувати код OpenCensus та використовувати його у своїх проєктах. Наявні релізи OpenCensus залишаться доступними у публічних репозиторіях пакунків, таких як NPM та PyPI. **Ми закликаємо всіх користувачів OpenCensus почати планування міграції своїх проєктів на OpenTelemetry зараз.**

Одним винятком є репозиторій [census-instrumentation/opencensus-python][][^python-timeline].

[go shim]:
https://github.com/open-telemetry/opentelemetry-go/tree/main/bridge/opencensus
[java shim]:
https://github.com/open-telemetry/opentelemetry-java/tree/main/opencensus-shim
[python shim]:
https://github.com/open-telemetry/opentelemetry-python/tree/main/shim/opentelemetry-opencensus-shim
[js shim]:
https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/packages/shim-opencensus
[census-instrumentation/opencensus-python]:
https://github.com/census-instrumentation/opencensus-python

[^python-timeline]:
Деякі проєкти в репозиторії `opencensus-python` все ще використовуються як рекомендовані промислові рішення. Ці проєкти будуть продовжувати підтримуватися. Для деталей щодо термінів підтримки, наступних кроків для міграції та загальних питань підтримки, звертайтеся до підтримувачів репозиторію.

[^shim-next-release]: Пакунки мостів для Python та JavaScript будуть випущені незабаром.

[^shim-support]:
Ці мости реалізують стабільну [специфікацію сумісності OpenCensus](/docs/specs/otel/compatibility/opencensus#migration-path) та будуть підтримуватися принаймні один рік відповідно до [довгострокових рекомендацій підтримки OpenTelemetry](/docs/specs/otel/versioning-and-stability/#long-term-support).
21 changes: 21 additions & 0 deletions content/uk/blog/2024/docs-localized.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: Вебсайт OpenTelemetry стає багатомовним!
linkTitle: Багатомовний вебсайт
date: 2024-08-20
author: >-
[Северін Нойманн](https://github.com/svrnm) (Cisco)
issue: 4863
sig: Comms
---

Ми раді повідомити, що вебсайт OpenTelemetry доступний кількома мовами! Команди з локалізації вже почали перекладати сторінки вебсайту на [китайську](/zh), [японську](/ja), [португальську](/pt) та [іспанську](/es).

Проєкт OpenTelemetry виріс до включення учасників та користувачів з усього світу. Зробити вебсайт доступним кількома мовами — це важливий крок для забезпечення того, щоб кожен, незалежно від рідної мови, міг зробити свій внесок у проєкт. Ми також раді, що ця ініціатива надає кінцевим користувачам доступ до багатомовної документації, що полегшує вивчення та розуміння OpenTelemetry.

Щоб отримати доступ до вебсайту вашою улюбленою мовою, скористайтеся селектором мови у верхньому правому куті сторінки.

Ми запрошуємо вас долучитися до цієї ініціативи. Ви можете знайти інших учасників локалізації у каналі Slack [#otel-docs-localization](https://cloud-native.slack.com/archives/C076RUAGP37). Якщо ви вільно володієте мовою, яка вже підтримується, ви можете допомогти, створюючи або переглядаючи переклади. Якщо ваша мова ще не підтримується і ви хочете допомогти з перекладом, [створіть тікет](<https://github.com/open-telemetry/opentelemetry.io/issues/new?title=Add+%3CYOUR%20LANGUAGE%3E+(%3CYOUR+CODE%3E)+version+of+website+pages&body=%3C!--+Provide+github+handles+of+at+least+2+people+that+will+work+on+this+translation+project%20--%3E>).

Ваші внески можуть мати значний вплив!

Ми дякуємо всім учасникам за те, що вони зробили це можливим, і з нетерпінням чекаємо, як ці нові мовні опції покращать досвід використання OpenTelemetry.
15 changes: 15 additions & 0 deletions content/uk/blog/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: Блог
menu: { main: { weight: 50 } }
redirects:
# Every January, update the year number in the paths below
- { from: '', to: '2024/ 302!' }
# Workaround to https://github.com/open-telemetry/opentelemetry.io/issues/4440:
- { from: 'index.xml', to: '2024/index.xml 302!' }
outputs: [HTML, RSS]
htmltest:
# 2024-11-07 DO NOT COPY the following IgnoreDirs to non-en pages because handles all locales.
IgnoreDirs:
# Ignore blog index pages for all locales and in all blog sections (top-level and years)
- ^(../)?blog/(\d+/)?page/\d+
---
20 changes: 20 additions & 0 deletions content/uk/community/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: Спільнота
menu: { main: { weight: 40 } }
cascade:
type: docs
---

{{% community-lists %}}

## Участь у групах кінцевих користувачів {#participate-in-end-user-groups}

Зацікавлені у спілкуванні з іншими кінцевими користувачами та наданні відгуку розробникам OpenTelemetry? Дізнайтеся більше на сторінці [Ресурси для кінцевих користувачів](/community/end-user/).

## Спеціальні робочі групи {#special-interest-groups}

Ми організовували спільноту у Спеціальні Робочі Групи (Special Interest Groups, SIGs), щоб покращити нашу робочий процес та легше керувати проєктом. [Дізнайтеся більше](https://github.com/open-telemetry/community#special-interest-groups) у нашому [репозиторії спільноти](https://github.com/open-telemetry/community).

## Екосистема {#ecosystem}

Шукаєте компоненти, приклади, інтеграції та більше? Дивіться [Екосистему](/ecosystem/).
Loading
Loading