[WIP]:DOCTEAM-2075-FQDN by Amrita42 · Pull Request #634 · SUSE/doc-modular

Amrita42 · 2026-01-22T10:05:27Z

PR creator: Description

Describe the overall goals of this pull request.

PR creator: Are there any relevant issues/feature requests?

bsc#...
jsc#...

PR reviewer: Checklist for editorial review

Apart from the usual checks, please double-check also the following:

do any new files fulfill the naming conventions specified in https://github.com/SUSE/doc-modular/blob/main/templates/README.md?
article title/structure title: does it have the required length and does it use sentence style capitalization?
revhistory: is it up-to-date and does it follow the guidelines specified in https://documentation.suse.com/style/current/html/style-guide-db/sec-smartdocs.html#sec-revhistory?
metadata: does it follow the guidlines specified in https://documentation.suse.com/style/current/html/style-guide-db/sec-smartdocs.html#sec-taglist-smartdocs?

Amrita42 · 2026-02-04T10:58:35Z

SLES-fqdn_en.pdf

Amrita42 · 2026-03-26T07:34:35Z

@dariavladykina ptal thanks

dariavladykina

Hi Amrita, please see some suggestions here. Thanks!

dariavladykina · 2026-03-30T14:42:53Z

articles/fqdn.asm.xml

+<!-- S T R U C T U R E -->
+  <structure renderas="article" xml:id="fqdn" xml:lang="en">
+    <merge>
+      <title>Understanding FQDN </title>


Suggested change

<title>Understanding FQDN </title>

<title>Understanding and Configuring FQDNs</title>

dariavladykina · 2026-03-30T14:44:03Z

articles/fqdn.asm.xml

+      </meta>
+
+      <!-- Social Media -->
+      <meta name="title" its:translate="yes">Introduction to FQDN</meta>


Suggested change

<meta name="title" its:translate="yes">Introduction to FQDN</meta>

<meta name="title" its:translate="yes">Configure FQDN on &sles; 16</meta>

dariavladykina · 2026-03-30T14:50:59Z

articles/fqdn.asm.xml

+       </meta>
+
+      <!-- Search -->
+      <meta name="description" its:translate="yes">Use FQDN for a unique and absolute digital address that ensures internet traffic, emails and security certificates reach one specific server without any risk of ambiguity or misdirection.</meta>


Suggested change

<meta name="description" its:translate="yes">Use FQDN for a unique and absolute digital address that ensures internet traffic, emails and security certificates reach one specific server without any risk of ambiguity or misdirection.</meta>

<meta name="description" its:translate="yes">Use an FQDN as a unique digital address to ensure Internet traffic, e-mails and security certificates reach a specific server without any ambiguity</meta>

dariavladykina · 2026-03-30T14:52:13Z

articles/fqdn.asm.xml

+
+      <!-- Social Media -->
+      <meta name="title" its:translate="yes">Introduction to FQDN</meta>
+      <meta name="social-descr" its:translate="yes">An FQDN is important because it provides a unique, globally recognized address that ensures internet traffic and security protocols, like SSL, reach the exact server intended without any ambiguity.


Suggested change

<meta name="social-descr" its:translate="yes">An FQDN is important because it provides a unique, globally recognized address that ensures internet traffic and security protocols, like SSL, reach the exact server intended without any ambiguity.

<meta name="social-descr" its:translate="yes">Set up an FQDN for unique server identification

dariavladykina · 2026-03-30T14:54:15Z

articles/fqdn.asm.xml

+            <term>WHAT?</term>
+            <listitem>
+              <para>
+                An FQDN is essential because it provides a unique and global identity for a device, ensuring that internet traffic, SSL security certificates and email deliveries reach the exact intended server without any ambiguity.


Suggested change

An FQDN is essential because it provides a unique and global identity for a device, ensuring that internet traffic, SSL security certificates and email deliveries reach the exact intended server without any ambiguity.

A Fully Qualified Domain Name (FQDN) is a network identifier that specifies a host’s exact location within the Domain Name System (DNS) hierarchy.

dariavladykina · 2026-03-30T15:39:04Z

references/configure-fqdn.xml

+    <abstract>
+      <para>
+ A system's FQDN is the absolute name returned by the <literal>resolver(3)</literal> library when queried for the local hostname.
+ It represents the complete hierarchy of the host, typically formatted as the hostname appended with the DNS domain name, for example; test.example.com.


Suggested change

It represents the complete hierarchy of the host, typically formatted as the hostname appended with the DNS domain name, for example; test.example.com.

It represents the complete hierarchy of the host, typically formatted as the hostname appended with the DNS domain name; for example: test.example.com.

dariavladykina · 2026-03-30T15:51:14Z

references/configure-fqdn.xml

+<important><para>
+It is recommended not to set FQDN as the hostname in the <filename>/etc/hostname</filename> file , as it does not conform to RFC 1178 and may cause some applications to behave unexpectedly. For more information, refer:
+<link xlink:href="https://www.ietf.org/rfc/rfc1178.txt"/>. </para>
+<para>The recommended approach is to allow the resolver to discover a host's FQDN at run time, based on DNS information or entries in the <filename>/etc/hosts</filename> file.


Suggested change

<para>The recommended approach is to allow the resolver to discover a host's FQDN at run time, based on DNS information or entries in the <filename>/etc/hosts</filename> file.

<para>The recommended approach is to allow the resolver to discover a host's FQDN at

runtime, based on DNS information or entries in the <filename>/etc/hosts</filename> file.

dariavladykina · 2026-03-30T15:51:31Z

references/configure-fqdn.xml

+<link xlink:href="https://www.ietf.org/rfc/rfc1178.txt"/>. </para>
+<para>The recommended approach is to allow the resolver to discover a host's FQDN at run time, based on DNS information or entries in the <filename>/etc/hosts</filename> file.
+Note that &systemd; uses the content of the <filename>/etc/hostname</filename> file as is.</para></important>
+<para>To configure FQDN, you can use the command-line or directly edit the specific files.</para>


Suggested change

<para>To configure FQDN, you can use the command-line or directly edit the specific files.</para>

<para>To configure an FQDN, you can use the command-line or directly edit the specific files.</para>

dariavladykina · 2026-03-30T15:51:51Z

references/configure-fqdn.xml

+Note that &systemd; uses the content of the <filename>/etc/hostname</filename> file as is.</para></important>
+<para>To configure FQDN, you can use the command-line or directly edit the specific files.</para>
+<itemizedlist>
+<listitem><para>To configure a FQDN on a &sles; 16 system, run:</para>


Suggested change

<listitem><para>To configure a FQDN on a &sles; 16 system, run:</para>

<listitem><para>To configure an FQDN on a &sles; 16 system, run:</para>

dariavladykina · 2026-03-30T15:53:03Z

tasks/fqdn-troubleshooting.xml

+  <variablelist>
+    <varlistentry>
+      <term><emphasis>Check the DNS records</emphasis></term>
+      <listitem> <para>If your FQDN is not resolving, verifying your DNS records.A record maps your domain to an IP address. Ensure it points to the correct server.


Suggested change

<listitem> <para>If your FQDN is not resolving, verifying your DNS records.A record maps your domain to an IP address. Ensure it points to the correct server.

<listitem> <para>If your FQDN is not resolving, verify your DNS records. A record maps your domain to an IP address. Ensure it points to the correct server.

dariavladykina

Hi Amrita, please see some suggestions here. Thanks!

toc-fqdn

827c3e7

Amrita42 self-assigned this Jan 22, 2026

Amrita42 added 12 commits January 29, 2026 18:58

what is

7674eba

imp

1bb6103

need

02ae854

need and troubleshot

3b7026b

troubleshoot

98d4ba7

more info

23a2954

final touches

4878d1b

self review

543e15b

self reeview

fe6702e

review

b3871ef

final self review

e966182

review

855854d

Amrita42 added 2 commits February 18, 2026 15:44

tech review feedback

71a7660

self review

4cda76a

Amrita42 requested a review from dariavladykina March 26, 2026 07:34

dariavladykina reviewed Mar 30, 2026

View reviewed changes

	<title>Understanding FQDN </title>
	<title>Understanding and Configuring FQDNs</title>

	<meta name="title" its:translate="yes">Introduction to FQDN</meta>
	<meta name="title" its:translate="yes">Configure FQDN on &sles; 16</meta>

	<meta name="description" its:translate="yes">Use FQDN for a unique and absolute digital address that ensures internet traffic, emails and security certificates reach one specific server without any risk of ambiguity or misdirection.</meta>
	<meta name="description" its:translate="yes">Use an FQDN as a unique digital address to ensure Internet traffic, e-mails and security certificates reach a specific server without any ambiguity</meta>

	<meta name="social-descr" its:translate="yes">An FQDN is important because it provides a unique, globally recognized address that ensures internet traffic and security protocols, like SSL, reach the exact server intended without any ambiguity.
	<meta name="social-descr" its:translate="yes">Set up an FQDN for unique server identification

	An FQDN is essential because it provides a unique and global identity for a device, ensuring that internet traffic, SSL security certificates and email deliveries reach the exact intended server without any ambiguity.
	A Fully Qualified Domain Name (FQDN) is a network identifier that specifies a host’s exact location within the Domain Name System (DNS) hierarchy.

	It represents the complete hierarchy of the host, typically formatted as the hostname appended with the DNS domain name, for example; test.example.com.
	It represents the complete hierarchy of the host, typically formatted as the hostname appended with the DNS domain name; for example: test.example.com.

	<para>The recommended approach is to allow the resolver to discover a host's FQDN at run time, based on DNS information or entries in the <filename>/etc/hosts</filename> file.
	<para>The recommended approach is to allow the resolver to discover a host's FQDN at
	runtime, based on DNS information or entries in the <filename>/etc/hosts</filename> file.

	<para>To configure FQDN, you can use the command-line or directly edit the specific files.</para>
	<para>To configure an FQDN, you can use the command-line or directly edit the specific files.</para>

	<listitem><para>To configure a FQDN on a &sles; 16 system, run:</para>
	<listitem><para>To configure an FQDN on a &sles; 16 system, run:</para>

	<listitem> <para>If your FQDN is not resolving, verifying your DNS records.A record maps your domain to an IP address. Ensure it points to the correct server.
	<listitem> <para>If your FQDN is not resolving, verify your DNS records. A record maps your domain to an IP address. Ensure it points to the correct server.

Conversation

Amrita42 commented Jan 22, 2026

PR creator: Description

PR creator: Are there any relevant issues/feature requests?

PR reviewer: Checklist for editorial review

Uh oh!

Amrita42 commented Feb 4, 2026

Uh oh!

Amrita42 commented Mar 26, 2026

Uh oh!

dariavladykina left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dariavladykina left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants