[PATCH] Documented opensourcing of the OTel module

Yaroslav Zhuravlev yar at nginx.com
Fri Feb 23 10:32:29 UTC 2024


Hi, 

Thank you for the review, committed: http://hg.nginx.org/nginx.org/rev/48c688d80004


> On 6 Feb 2024, at 11:44, Yaroslav Zhuravlev <yar at nginx.com> wrote:
> 
> 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