fdp-primer: Add trademark section (draft)

[dbaio]

Summary

Rendered document here.

[bcr]

It's a good start, thanks.
I added few language corrections and simplifications.

documentation/content/en/books/fdp-primer/trademarks/_index.adoc

59

s/In doubt/When in doubt/

Also, to have fewer commas, maybe write:

When in doubt, research the company on the Internet or the software's website in addition to the ...

64

Maybe: ... provides a template to cite...?
and
s/in a manner of not have to/to avoid/

84

s/trademarks/trademark/

95

s/can make the maintenance of the trademarks/can maintain the trademarks/

[dbaio]

• Address bcr's items

Rendered document updated.

[dbaio]

@bcr Thanks for reviewing.

[carlavilla]

Thanks for doing this :)

[emaste]

documentation/content/en/books/fdp-primer/trademarks/_index.adoc

56

We should use ™ and ® where necessary (via AsciiDoc escapes, if applicable), not (TM) or (R). And drop "at least", we do not need to use the symbol on every instance of the trademark. If we need it at all, using it on the first is sufficient.

For reference, the Linux Foundation's request is (https://www.linuxfoundation.org/the-linux-mark/):

1. For each web page, advertisement, or publication, the first prominent appearance of LINUX should feature the “circle R” character adjacent to the X, as follows:

Linux®

2. At the end of your web page, advertisement, publication or media broadcast, include the following text in a legible font and size:

Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.

Note that this is a request, and it matches our current practice but is probably not necessary. So above I would write "it is customary to cite..."

[jhb]

documentation/content/en/books/fdp-primer/trademarks/_index.adoc

64

I would say "provides a template for citing trademarks to avoid duplicating trademark information in each document"

66

Maybe:

First, check the project's template for the trademark.
If there is not an existing entry for the trademark, add a new one.
Second, add the trademark to the `trademarks` tag in the `Front Matter` section at the top of the document.

Possibly s/top/start/ or s/top/beginning/

95

Perhaps s/maintain/update/?

[dbaio]

• Address topics from emaste and jhb.

[dbaio]

Thanks @emaste and @jhb .

Rendered document here.

Regards.

documentation/content/en/books/fdp-primer/trademarks/_index.adoc

56

Thanks for the feedback and information.

(TM) or (R) renders as ™ and ®.

Do you think an example like this from Linux can be useful?

[carlavilla]

If there's no more corrections. Can we merge this?

[emaste]

No objection from me, we can always iterate on it in the tree if anything new comes up

[bcr]

I'm OK with this new version to be committed.

[dbaio]

Thank you all, I'll push this.