[PATCH] Documented opensourcing of the OTel module

Yaroslav Zhuravlev yar at nginx.com
Tue Feb 6 11:44:56 UTC 2024


Hi Maxim, 

Thank you for your comments, fixed, new version ready.

>> <para>
>> -The <literal>ngx_otel_module</literal> module (1.23.4) provides
>> +The <literal>ngx_otel_module</literal> module (1.23.4) is nginx-authored
> 
> Quoting from 
> https://mailman.nginx.org/pipermail/nginx-devel/2023-October/4AGH5XVKNP6UDFE32PZIXYO7JQ4RE37P.html:
> 
> : Note that "nginx-authored" here looks misleading, as no nginx core 
> : developers work on this module.

Fixed, thanks

> 
>> +<link url="https://github.com/nginxinc/nginx-otel">third-party module</link>
>> +that provides
>> <link url="https://opentelemetry.io">OpenTelemetry</link>
>> distributed tracing support.
>> The module supports
>> @@ -23,12 +25,20 @@
>> </para>
>> 
>> <para>
>> +The module is open source since 1.25.2.
>> +Download and install instructions are available
>> +<link url="https://github.com/nginxinc/nginx-otel/blob/main/README.md">here</link>.
>> +The module is also available as a prebuilt
>> +<literal>nginx-module-otel</literal> dynamic module
>> +<link doc="../linux_packages.xml" id="dynmodules">package</link> (1.25.4).
>> +</para>
>> +
>> +<para>
>> <note>
>> This module is available as part of our
>> <commercial_version>commercial subscription</commercial_version>
>> -in <literal>nginx-plus-module-otel</literal> package.
>> -After installation, the module can be loaded
>> -<link doc="ngx_core_module.xml" id="load_module">dynamically</link>.
>> +(the
>> +<link url="https://docs.nginx.com/nginx/admin-guide/dynamic-modules/opentelemetry"><literal>nginx-plus-module-otel</literal></link> package).
> 
> I don't see reasons to provide additional links here.  Rather, the 
> note probably can be removed altogether, or changed to something 
> like "In previuos versions, this module is available...".

Removed, thanks

[...]

New version: 

# HG changeset patch
# User Yaroslav Zhuravlev <yar at nginx.com>
# Date 1704815768 0
#      Tue Jan 09 15:56:08 2024 +0000
# Node ID 014598746fcb5dc953b15a6ea0de5410a7ecae6a
# Parent  e6b785b7e3082fcde152b59b460448a33ec7df64
Documented opensourcing of the OTel module.

diff --git a/xml/en/docs/index.xml b/xml/en/docs/index.xml
--- a/xml/en/docs/index.xml
+++ b/xml/en/docs/index.xml
@@ -8,7 +8,7 @@
 <article name="nginx documentation"
          link="/en/docs/"
          lang="en"
-         rev="49"
+         rev="50"
          toc="no">
    @@ -681,6 +681,12 @@
 ngx_mgmt_module</link>
 </listitem>
  +</list>
+</para>
+
+<para>
+<list type="bullet">
+
 <listitem>
 <link doc="ngx_otel_module.xml">
 ngx_otel_module</link>
diff --git a/xml/en/docs/ngx_otel_module.xml b/xml/en/docs/ngx_otel_module.xml
--- a/xml/en/docs/ngx_otel_module.xml
+++ b/xml/en/docs/ngx_otel_module.xml
@@ -9,12 +9,14 @@
 <module name="Module ngx_otel_module"
         link="/en/docs/ngx_otel_module.html"
         lang="en"
-        rev="1">
+        rev="2">
   <section id="summary">
   <para>
-The <literal>ngx_otel_module</literal> module (1.23.4) provides
+The <literal>ngx_otel_module</literal> module (1.23.4) is a
+<link url="https://github.com/nginxinc/nginx-otel">third-party module</link>
+that provides
 <link url="https://opentelemetry.io">OpenTelemetry</link>
 distributed tracing support.
 The module supports
@@ -23,13 +25,11 @@
 </para>
   <para>
-<note>
-This module is available as part of our
-<commercial_version>commercial subscription</commercial_version>
-in <literal>nginx-plus-module-otel</literal> package.
-After installation, the module can be loaded
-<link doc="ngx_core_module.xml" id="load_module">dynamically</link>.
-</note>
+Download and install instructions are available
+<link url="https://github.com/nginxinc/nginx-otel/blob/main/README.md">here</link>.
+The module is also available as a prebuilt
+<literal>nginx-module-otel</literal> dynamic module
+<link doc="../linux_packages.xml" id="dynmodules">package</link> (1.25.3).
 </para>
   </section>
diff --git a/xml/ru/docs/index.xml b/xml/ru/docs/index.xml
--- a/xml/ru/docs/index.xml
+++ b/xml/ru/docs/index.xml
@@ -8,7 +8,7 @@
 <article name="nginx: документация"
          link="/ru/docs/"
          lang="ru"
-         rev="49"
+         rev="50"
          toc="no">
    @@ -687,9 +687,15 @@
 ngx_mgmt_module</link> [en]
 </listitem>
  +</list>
+</para>
+
+<para>
+<list type="bullet">
+
 <listitem>
 <link doc="ngx_otel_module.xml">
-ngx_otel_module [en]</link>
+ngx_otel_module</link> [en]
 </listitem>
   </list>




More information about the nginx-devel mailing list