commit: 75a0de8654435df5ca5b12b2670e24258d30ffc9 Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Wed Jan 15 22:35:17 2020 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Wed Jan 15 22:35:17 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=75a0de86
devbook-guide: Remove obsolete text in "<uri>" subsection. Linking to other parts of the Gentoo web site doesn't apply to us, because the devmanual isn't at www.gentoo.org. Consistently have a trailing slash in example URIs. Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> appendices/devbook-guide/text.xml | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index 5f084bb..9b7a0c3 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -163,7 +163,7 @@ an example <c><body></c> element: <codesample lang="sgml"><!-- Example of a body element --> <p> This is a paragraph. <c>/etc/passwd</c> is a file. -<uri>https://forums.gentoo.org</uri> is my favorite website. +<uri>https://forums.gentoo.org/</uri> is my favorite website. Type <c>ls</c> if you feel like it. I <e>really</e> want to go to sleep now. </p> @@ -196,7 +196,7 @@ Now, here's how the <c><body></c> element above is rendered: <p> This is a paragraph. <c>/etc/passwd</c> is a file. -<uri>https://forums.gentoo.org</uri> is my favorite web site. +<uri>https://forums.gentoo.org/</uri> is my favorite web site. Type <c>ls</c> if you feel like it. I <e>really</e> want to go to sleep now. </p> @@ -370,13 +370,7 @@ displayed in the body text, such as this link to when you want to associate a URI with some other text <d/> for example, <uri link="https://forums.gentoo.org/">the Gentoo Forums</uri>. To create <e>this</e> link, I typed <c><uri link="https://forums.gentoo.org/">the -Gentoo Forums</uri></c>. You don't need to write -<c>https://www.gentoo.org/</c> to link to other parts of the Gentoo web site. -For instance, a link to the <uri link="/doc/en/">documentation main index</uri> -should be simply <c><uri link="/doc/en/index.xml">documentation main -index</uri></c>. You can even omit <c>index.xml</c> when you link to a -directory index, e.g. <c><uri link="/doc/en/">documentation main -index</uri></c>. Leaving the trailing slash saves an extra HTTP request. +Gentoo Forums</uri></c>. </p> <p> @@ -649,8 +643,8 @@ with a capital letter. <p> Try to use <c><uri></c> with the <c>link</c> attribute as much as -possible. In other words, the <uri link="https://forums.gentoo.org">Gentoo -Forums</uri> is preferred over <uri>https://forums.gentoo.org</uri>. +possible. In other words, the <uri link="https://forums.gentoo.org/">Gentoo +Forums</uri> is preferred over <uri>https://forums.gentoo.org/</uri>. </p> </body>