Improve wording in Contributing article

[sevan]

Summary

Bug 212992
[e-mail]

[bcr]

Can you check the change with textproc/igor? I'm not sure about the tabs at the beginning of some of the lines that were changed.

en_US.ISO8859-1/articles/contributing/article.xml

95 ↗

(On Diff #32224)

I think there is a line break necessary here, it flows over the line too much.

[sevan]

Add line break and rewrap.

[bcr]

A style nit.

en_US.ISO8859-1/articles/contributing/article.xml

97 ↗

(On Diff #32258)

This xlink needs to be indented and all other lines after it until the closing </link>.

[sevan]

Indented like so??

[bcr]

More info on proper link indentation. You're getting there...

en_US.ISO8859-1/articles/contributing/article.xml

474 ↗

(On Diff #38090)

You can also break overlong lines (where links are definitely too long for the current line like this:

visit the Foundation <link
 xlink:href="https://www.freebsdfoundation.org">web
 site</link>

Basic rule: if you are within an overlong tag (like the link above), then you need to further indent the line until the closing (</link>) tag. Then, the current level of indentation is used like before the opening (<link>) tag. Check the examples at the bottom of this page: https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/docbook-markup-links.html

[bcr]

ping?

[sevan]

Adjust indentation.

[bcr]

Great, thanks!

[sevan]

en_US.ISO8859-1/articles/contributing/article.xml

478 ↗

(On Diff #40355)

This address is no longer valid and bounces. Do you have any recommendation on what it should be changed to?

474 ↗

(On Diff #38090)

like so?