Bug 264411 - Contributors to FreeBSD: linking; and "the FreeBSD source tree" is ambiguous (there is not just one tree)
Summary: Contributors to FreeBSD: linking; and "the FreeBSD source tree" is ambiguous ...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL: https://github.com/freebsd/freebsd-do...
Keywords:
Depends on:
Blocks:
 
Reported: 2022-06-02 09:20 UTC by Graham Perrin
Modified: 2022-06-29 21:22 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2022-06-02 09:20:19 UTC
The abstract <https://docs.freebsd.org/en/articles/contributors/#preamble> might benefit from a link to <https://www.freebsd.org/internal/members/>. Cross-reference: bug 264410. 

----

Under <https://docs.freebsd.org/en/articles/contributors/#staff-committers>: 

> These are the people who have commit privileges and do the 
> engineering work on the FreeBSD source tree. All 
> core team members are also developers. 
> 
> (in alphabetical order by last name):

For the "source tree" (singular), I assumed /src/

As an example: names include Gordon Bergling, who, according to the three lists below, has a commit bit for /doc/ but not for /src/

<https://github.com/freebsd/freebsd-src/blob/main/share/misc/committers-doc.dot>
<https://github.com/freebsd/freebsd-src/blob/main/share/misc/committers-ports.dot>
<https://github.com/freebsd/freebsd-src/blob/main/share/misc/committers-src.dot>

– so, a false assumption. 

----

Let's make the descriptive paragraph less ambiguous. Maybe: 

> This list, which includes all members of the Core Team, names everyone 
> who has commit privileges for one or more of the three source trees 
> (doc, ports and src). By surname: 

– and include a link to <https://www.freebsd.org/administration/#t-core>.
Comment 1 commit-hook freebsd_committer freebsd_triage 2022-06-29 21:21:14 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=4a5b42a96c0f644fa367e98b1ea1f74bdfcb8b4f

commit 4a5b42a96c0f644fa367e98b1ea1f74bdfcb8b4f
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-06-29 21:18:16 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-06-29 21:18:16 +0000

    Improve Abstract section and some other improvements in Contributors

    * Improve abstract
    * Clarify that source tree make reference to all
      FreeBSD source trees (src, ports and doc)
    * Add a link to the current members of the Core Team

    PR:             264411
    Submitted by:   grahamperrin@

 documentation/content/en/articles/contributors/_index.adoc | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
Comment 2 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-06-29 21:22:00 UTC
Fixed!