docs-archive/sysadmin-guide
Archived
21
1
Fork 3
Code Issues 26 Pull requests 2 Activity

[f37] Doc issue in file modules/system-administrators-guide/pages/servers/Web_Servers.adoc #5

New issue
Closed
opened 2022-12-24 04:40:15 +00:00 by atriwidada · 5 comments
atriwidada commented 2022-12-24 04:40:15 +00:00 (Migrated from gitlab.com)
Copy link

Published page of Sysadmin Guide - Web Servers show some out-of-place items. See screenshot.!2027-12-24_11-37-55](/uploads/6e575736b3c315d8d16746068ea5d04c/Screenshot_from_2022-12-24_11-37-55.png)

Published page of Sysadmin Guide - Web Servers show some out-of-place items. See screenshot.!2027-12-24_11-37-55](/uploads/6e575736b3c315d8d16746068ea5d04c/Screenshot_from_2022-12-24_11-37-55.png)
p.boy commented 2023-01-10 19:55:45 +00:00 (Migrated from gitlab.com)
Copy link

The page link is:
https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/servers/Web_Servers/

The source code is:

:experimental:
include::{partialsdir}/entities.adoc[]

[[ch-Web_Servers]]
= Web Servers
indexterm:[HTTP server,Apache HTTP Server]indexterm:[web server,Apache HTTP Server]
A _web server_ is a network service that serves content to a client over the web. This typically means web pages, but any other documents can be served as well. Web servers are also known as HTTP servers, as they use the _hypertext transport protocol_ (*HTTP*).

include::{partialsdir}/servers/The_Apache_HTTP_Server.adoc[]

I don't know what happens, if we remove line 6 in the above excerpt.

On the other hand, we have an article in Quick Docs.

  • Should we remove the complete section and link to Quick Docs?
  • Should we fix it at all (the complete guide is outdatedand will be removed)?
  • Should we add a proviso on the first page informing about the maintenance-mode status?
The page link is: https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/servers/Web_Servers/ The source code is: ``` :experimental: include::{partialsdir}/entities.adoc[] [[ch-Web_Servers]] = Web Servers indexterm:[HTTP server,Apache HTTP Server]indexterm:[web server,Apache HTTP Server] A _web server_ is a network service that serves content to a client over the web. This typically means web pages, but any other documents can be served as well. Web servers are also known as HTTP servers, as they use the _hypertext transport protocol_ (*HTTP*). include::{partialsdir}/servers/The_Apache_HTTP_Server.adoc[] ``` I don't know what happens, if we remove line 6 in the above excerpt. On the other hand, we have an article in Quick Docs. * Should we remove the complete section and link to Quick Docs? * Should we fix it at all (the complete guide is outdatedand will be removed)? * Should we add a proviso on the first page informing about the maintenance-mode status?
atriwidada commented 2023-01-11 01:17:00 +00:00 (Migrated from gitlab.com)
Copy link

Configuring the Date and Time and Gaining Privileges which doesn't include 'indexterm:' line right after title, are ok. While Opening Graphical Application, System Locale and Keyboard Configuration, and Managing User and Groups among others, has similar problem.

[Configuring the Date and Time](https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/basic-system-configuration/Configuring_the_Date_and_Time/) and [Gaining Privileges](https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/basic-system-configuration/Gaining_Privileges/) which doesn't include 'indexterm:' line right after title, are ok. While [Opening Graphical Application](https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/basic-system-configuration/Opening_GUI_Applications/), [System Locale and Keyboard Configuration](https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/basic-system-configuration/Opening_GUI_Applications/), and [Managing User and Groups](https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/basic-system-configuration/Managing_Users_and_Groups/) among others, has similar problem.
darknao commented 2023-01-11 20:30:31 +00:00 (Migrated from gitlab.com)
Copy link

Agreed that the indexterm line can be safely removed (from any article) as our Docs site doesn't make use of it anyway.

Agreed that the `indexterm` line can be safely removed (from any article) as our Docs site doesn't make use of it anyway.
p.boy commented 2023-01-12 08:18:11 +00:00 (Migrated from gitlab.com)
Copy link

mentioned in commit 00e57ff725

mentioned in commit 00e57ff725e2e0373d1f2cc788a7625dc63ac1c5
p.boy commented 2023-01-12 15:23:36 +00:00 (Migrated from gitlab.com)
Copy link

indexterm removed, Editor's Note added indicating deprecated status.

indexterm removed, Editor's Note added indicating deprecated status.
p.boy (Migrated from gitlab.com) closed this issue 2023-01-12 15:23:36 +00:00
Commenting is not possible because the repository is archived.
No Branch/Tag specified
Branches Tags
main
f41
f39
f40
f38
f37
f35
cherry-pick-82f2ace5
f36
f34
f26
f27
f28
f29
f30
f31
f32
f33
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
docs-archive/sysadmin-guide#5
No description provided.