Update PH's security chapter: document modern way to work with vulndb

[ak]

Summary

Update Porter's Handbook Security chapter: document modern way to work with vulnerability database.

[wblock]

porters-handbook/security/chapter.xml

419 ↗

(On Diff #1974)

I do not see a reason for the <emphasis>. Also, s/fresh/a fresh/.

445 ↗

(On Diff #1974)

This whole sentence can be simpler:
<para>Verify that the <literal>&lt;affected&gt;</literal> section of the entry will match the correct packages:</para>

[ak]

Thanks for the suggestions, patch updated.

[wblock]

en_US.ISO8859-1/books/porters-handbook/security/chapter.xml

446 ↗

(On Diff #1975)

Please do not use "package(s)", it's unnecessarily complicated and a legacy of lazy programming. "Packages" means "zero or more" and is simpler.

porters-handbook/security/chapter.xml

8 ↗

(On Diff #1974)

Again, <emphasis> seems unnecessary.

[ak]

Please do not use "package(s)", it's unnecessarily complicated and a legacy of lazy programming. "Packages" means "zero or more" and is simpler.

Fixed.

Again, <emphasis> seems unnecessary.

There are two more left in this chapter, but both seems appropriate:
https://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/books/porters-handbook/security/chapter.xml?annotate=45641#l104
https://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/books/porters-handbook/security/chapter.xml?annotate=45641#l152

Btw, if you reviewing whole chapter, can you please help to reword next paragraph?
https://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/books/porters-handbook/security/chapter.xml?annotate=45641#l117
It looks really ugly.

[wblock]

In D941#10, @ak wrote:

Please do not use "package(s)", it's unnecessarily complicated and a legacy of lazy programming. "Packages" means "zero or more" and is simpler.

Fixed.

Again, <emphasis> seems unnecessary.

There are two more left in this chapter, but both seems appropriate:
https://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/books/porters-handbook/security/chapter.xml?annotate=45641#l104
https://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/books/porters-handbook/security/chapter.xml?annotate=45641#l152

Yes, those are fine.

Btw, if you reviewing whole chapter, can you please help to reword next paragraph?
https://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/books/porters-handbook/security/chapter.xml?annotate=45641#l117
It looks really ugly.

Okay. This is without regard to whitespace:

<para>Committers can update the <acronym>VuXML</acronym> database

themselves, assisting the Security Officer Team and delivering crucial
information to the community more quickly.  Those who are
not committers or have discovered an exceptionally severe 
vulnerability should not hesitate to contact the Security Officer 
Team directly, as described on the <link
  xlink:href="http://www.freebsd.org/security/#how">&os; Security 
  Information</link> page.</para>

[ak]

Okay. This is without regard to whitespace:

Thank you.

[wblock]

Looks good. Please build-test before commit.

[ak]

Closed by commit rD45838 (authored by @ak).