[Bug 213564] [handbook] [patch] clarify Updating FreeBSD chapter to contrast binary-only and source-based upgrade strategies

[bugzilla-noreply at freebsd.org]

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

            Bug ID: 213564
           Summary: [handbook] [patch] clarify Updating FreeBSD chapter to
                    contrast binary-only and source-based upgrade
                    strategies
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Keywords: patch
          Severity: Affects Many People
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: linimon at FreeBSD.org
          Keywords: patch

Created attachment 175861
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=175861&action=edit
patch to handbook/cutting_edge

Currently Chapter 23 mixes these two types of content.  This may be confusing
to new users.

In particular, I see recurring questions on the mailing lists about problems
using freebsd-update in situations where it is may not be the best strategy.

A new Section is introduced, "Choosing a Strategy", which clearly shows what
part of the remaining chapter content is relevant to which strategy.  This is
introduced right after the Synopsis.

The Synopsis grows a reference to this section.  In addition, one excellent
line is pulled from the top of the FreeBSD Update section and moved the top
here.  There is some minor rewording to go with that.

A disclaimer is added to the FreeBSD Update section about which architectures
it is available for.  This is a hack; that information should be provided
elsewhere.  Right now the information is correct but misleading.

Finally, a minor change to the last section attempts to clarify that it is
applicable to source updates and only in certain environments.

-- 
You are receiving this mail because:
You are the assignee for the bug.