Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 10 Jan 2017 17:59:08 -0600
From:      Mark Linimon <linimon@lonesome.com>
To:        freebsd-ports@FreeBSD.org
Cc:        linimon@FreeBSD.org, marino@FreeBSD.org
Subject:   [CFD] changes to Handbook chapter on Ports
Message-ID:  <20170110235908.GA17113@lonesome.com>

next in thread | raw e-mail | index | archive | help
Executive summary: the chapter needed help, and still needs more.

Full explanation:

I have submitted https://reviews.freebsd.org/D9124 to add a section
about ports-mgmt/synth, and a compare-and-contrast table for it and
poudriere, portupgrade, and portmaster.  I fully expect this section
to be controversial.

My aim is twofold:

 - try to make our documentation as useful for our users as possible
   (while still trying to be succinct)

 - try to meet the objections that have arisen about its favorable
   treatment of portupgrade and portmaster.

I don't think the Handbook is the place for a full discussion of
the controversy around these tools (see "succinct").  I'll leave the
judgement about whether that should be a wiki entry, or a new Article,
to someone else.

When I started working on this task, I found that the whole chapter
was stale and sometimes awkward.  I submitted changes to Phabricator as:

  https://reviews.freebsd.org/D8838
  https://reviews.freebsd.org/D8839

which now correspond, respectively, to:

  https://svnweb.freebsd.org/doc?view=revision&revision=49827
  https://svnweb.freebsd.org/doc?view=revision&revision=49828

Although the reviews were made public, only my doc mentor (wblock)
commented.

A followup commit:

  https://svnweb.freebsd.org/doc?view=revision&revision=49829

was only reviewed between he and I.

I am somewhat hopeful that the above commits will invite minimum
controversy.  However, I am reasonably confident that D9124 will.

And now I'll sit back and await feedback.

References: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=214679

mcl



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20170110235908.GA17113>