Bug 273358 - FreeBSD Handbook: stable/11 and stable/12 described as legacy branches
Summary: FreeBSD Handbook: stable/11 and stable/12 described as legacy branches
Status: Closed Not Accepted
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Sergio Carlavilla Delgado
URL: https://docs.freebsd.org/en/books/han...
Keywords:
Depends on:
Blocks:
 
Reported: 2023-08-26 08:16 UTC by Graham Perrin
Modified: 2023-11-25 10:13 UTC (History)
4 users (show)

See Also:

Attachments
.patch (2.06 KB, patch)
2023-08-26 08:16 UTC, Graham Perrin 		no flags Details | Diff
Improved .patch (3.73 KB, patch)
2023-08-26 08:55 UTC, Graham Perrin 		grahamperrin: maintainer-approval? (releng)
 Details | Diff
Show Obsolete (1) View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin 2023-08-26 08:16:25 UTC 
Created attachment 244354 [details]
.patch

In a Note box: 

> … After March 2021, Subversion use is only for 
> legacy branches (stable/11 and stable/12).
Comment 1 Graham Perrin 2023-08-26 08:55:03 UTC 
Created attachment 244355 [details]
Improved .patch

Avoid this type of thing: 

> Users … use
Comment 2 Graham Perrin 2023-08-27 09:06:12 UTC 
Comment on attachment 244355 [details]
Improved .patch

From [PATCH 1/2]: 

> By no longer describing stable/11 and stable/12 as legacy, there's less to
> consider in
> https://bugs.freebsd.org/273017
Comment 3 Minsoo Choo 2023-11-24 17:59:40 UTC 
(In reply to Graham Perrin from comment #2)
<https://docs.freebsd.org/en/books/fdp-primer/writing-style/#writing-style-be-clear>

"Write in a formal style. Avoid addressing the reader as "you". For example, say "copy the file to /tmp" rather than "you can copy the file to /tmp"."

So "You may prefer to use" should be avoided
Comment 4 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-11-25 10:13:39 UTC 
I'm gonna close this, at the end of the year we're gonna remove all the info regarding SVN from the handbook, I have a review in phabricator for that