patches to Handbook ports section: part 2

[linimon]

Summary

This patch shuffles some text in the ports section of the Handbook.

The presentation assumes more knowledge on the part of a new user to FreeBSD than it should.

In good writing, concepts should always be introduced before being discussed. The current presentation mixes them. The new order introduces applications, then ports, then packages, and then elaborates on the difference between packages and ports.

90% of the content is merely moved. Some editing for clarity is included.

[linimon]

This comment was removed by linimon.

[linimon]

Add some more explanatory text to the refactor.

The render is at https://people.freebsd.org/~linimon/tmp/ports-using.D8839.html.

[wblock]

chapter.xml

103 ↗

(On Diff #23217)

Typo: adapated.

104 ↗

(On Diff #23217)

"...on &os;, the source code might need editing for it to install and run properly."

115 ↗

(On Diff #23217)

Can we remove this paragraph entirely?

850 ↗

(On Diff #23217)

Trying to think of a way to say this more simply. How about:
"The Ports Collection contains directories for software categories. Inside each category are subdirectories for each application. The application subdirectories contain a set..."

[linimon]

chapter.xml

115 ↗

(On Diff #23217)

Actually I believe it should remain. It introduces the concept that not every port maybe packaged.

[linimon]

Incorporates feedback.

Deletes a line that is now redundant (first introduction of category subdirectories). It is already explained better, below the two Procedures.

[wblock]

chapter.xml

825 ↗

(On Diff #23708)

"Each application" is repeated here, but it's not a huge thing.

[linimon]

• Incorporates latest feedback

[linimon]

full-context diff