-
Notifications
You must be signed in to change notification settings - Fork 1.3k
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
Andygol
wants to merge
23
commits into
open-telemetry:main
Choose a base branch
from
Andygol:main-uk
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
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 707db47
Add Ukrainian announcements and developer experience survey content
Andygol 70b78ef
Add Ukrainian community resources and feedback channels for OpenTelem…
Andygol be3d0fd
Add Ukrainian site information page
Andygol f43749b
Add Ukrainian ecosystem documentation for OpenTelemetry
Andygol e41739d
Add Ukrainian documentation for OpenTelemetry overview and Getting st…
Andygol f378a28
Add Ukrainian documentation for OpenTelemetry concepts
Andygol 89982ad
Add Ukrainian documentation for demo
Andygol fb360b0
Add Ukrainian documentation for various languages
Andygol b74c58e
Add Ukrainian documentation for zero-code instrumentation
Andygol a596675
Add Ukrainian documentation for OpenTelemetry Collector components
Andygol 75361a2
Add Ukrainian documentation for OpenTelemetry Operator and related co…
Andygol bfe7541
Add Ukrainian documentation for Functions as a Service (FaaS) and Lam…
Andygol 418180a
Add Ukrainian migration documentation for OpenTelemetry from OpenTrac…
Andygol a84fb06
Add Ukrainian documentation for specifications and status of OpenTele…
Andygol 183b77d
Add Ukrainian documentation for security best practices, CVEs, and in…
Andygol d52413f
Add Ukrainian blog post on sunsetting OpenCensus and create blog index
Andygol 2de71ae
Merge branch 'main' into main-uk
Andygol 495501e
[uk] Add configuration instructions for php.ini in PHP SDK documentation
Andygol c5fdb10
Update OpenCensus migration redirect link to include Ukrainian path
Andygol 8475e73
Update Ukrainian documentation for OpenTelemetry to improve clarity a…
Andygol e0a0f65
Add Ukrainian ecosystem documentation and update shortcode references
Andygol 1e195ef
Add blog post on multilingual OpenTelemetry website
Andygol File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 %}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
--- | ||
title: Анонси | ||
cascade: | ||
type: docs | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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] | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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+ | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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/). |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
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.