Re: Git-oriented and other documentation

On Fri, Apr 9, 2021 at 9:43 PM Graham Perrin <grahamperrin_at_gmail.com> wrote:

> On 10/04/2021 00:16, Kevin Oberman wrote:
>
>  > The updated mini-Git Primer is now included in the Developer's
> Handbook. See Chapter 5.
>
> Thanks!
>
> <https://docs.freebsd.org/en/articles/committers-guide/#git-primer>
>
> There's a slight discrepancy between
> <https://docs.freebsd.org/en/articles/committers-guide/#_shallow_clone>
> (Committer's Guide, undated) exemplifying '-o freebsd' and
> <https://docs.freebsd.org/en/books/handbook/mirrors/#git-usage> (FreeBSD
> Handbook, undated) without the option in at least one example.
>
> -o <name>, --origin <name> was recently discussed under
> <
> https://forums.FreeBSD.org/threads/ports-transitioned-to-git.79598/post-504699
> >
>

Yes. The examples in mirrors were written and copied from elsewhere about
the same time I decided to make all examples use  -o freebsd. I missed
these. I'm about  to push a fix.



>
> <
> https://docs.freebsd.org/en/books/developers-handbook/book.html#vendor-import-svn>
>
> (FreeBSD Developers' Handbook, 2021-01-12) there's some
> Subversion-related content in chapter five.
>

Yea, this chapter has been removed. Subversion is no longer relevant to
FreeBSD developers committing to the FreeBSD repo.


> <https://docs.freebsd.org/en/> lacks a sidebar and currently refers to
> what appears to be an older edition of the FreeBSD Developers' Handbook:
> <https://docs.freebsd.org/en/books/developers-handbook/> (2020-06-15,
> revision 54255 with reference to
> <https://cgit.freebsd.org/doc/commit/?id=> (bad link)).
>

I'll defer to others on this and following ones.

Warner


> <https://docs.freebsd.org/en/> is also mistakenly self-referencing when
> attempting to reach the FreeBSD home page (either click 'Home', or the
> FreeBSD icon).
>
> <https://www.freebsd.org/docs/> includes a sidebar.
>