Bug 265127

Summary:	Books and articles: Subversion (svn, svnlite etc.) long after the transition to Git
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	Graham Perrin <grahamperrin>
Status:	Closed Overcome By Events
Severity:	Affects Only Me	CC:	bofh, carlavilla, fernape
Priority:	---	Keywords:	needs-patch
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://wiki.freebsd.org/GitTransition
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257818 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264080 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=265126 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263315 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263333

Description Graham Perrin freebsd_committer

2022-07-10 10:20:54 UTC

<https://docs.freebsd.org/en/books/porters-handbook/book/>: 

* ten  mentions of Subversion
* nine mentions of svn

Comment 1 Graham Perrin freebsd_committer

2022-07-10 10:28:52 UTC

<https://docs.freebsd.org/en/books/handbook/book/>

* eighty-two mentions of Subversion
* fifty-nine mentions of svn, four or which are svnlite

Some of these mentions are valid. 

Some overlap with bug 257818. 

At a glance: it may be appropriate to remove the svnlite section <https://docs.freebsd.org/en/books/handbook/book/#svn-svnlite> from under 'Obtaining FreeBSD'.

Comment 2 Graham Perrin freebsd_committer

2022-07-10 11:09:05 UTC

(In reply to Graham Perrin from comment #1)

> … At a glance: it may be appropriate to remove …

Sorry, I overlooked the context under <https://docs.freebsd.org/en/books/handbook/mirrors/#svn-intro>: 

> … source code and documentation. Changes from the git repo … stable/12 and related releng branches are exported to the subversion repository. This export will continue through the life of these branches. …

So, removal now would be premature.

Comment 3 Graham Perrin freebsd_committer

2022-07-10 11:48:19 UTC

(In reply to Graham Perrin from comment #0)

<https://docs.freebsd.org/en/books/porters-handbook/book/#testing-poudriere-setup>

> … the FreeBSD Handbook Subversion section.

* refers to non-existent 
  <https://docs.freebsd.org/en/books/handbook/#svn-mirrors>

----

(In reply to Graham Perrin from comment #2)

> … removal now would be premature.

On the other hand, let's not forget <https://docs-legacy.freebsd.org/doc/12.3-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/> for users of 12.3-RELEASE. 

<https://docs.freebsd.org/doc/> is signposted from the front page of the current edition of the FreeBSD Handbook.

Comment 4 Fernando Apesteguía freebsd_committer

2022-10-09 16:06:28 UTC

^Triage: reporter is committer, assign accordingly.

Comment 5 Muhammad Moinur Rahman freebsd_committer

2022-10-09 17:09:32 UTC

I did plan to remove references of svn but as this is still the recommended method for stable/12 branch I would advise not to remove it until we reach EOL for stable/12.

Comment 6 Sergio Carlavilla Delgado freebsd_committer

2023-07-17 16:21:38 UTC

There's no more mentions of svn/subversion in the porter's handbook.
And in the Handbook we need to wait til the end of 12.x

Since I have this review [1], I'm gonna close this PR.

[1] https://reviews.freebsd.org/D37241