Bug 265267

Summary:	portmgr is Ports Management Team, so "the portmgr team" is a strange phrase
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Website	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed FIXED
Severity:	Affects Some People	CC:	carlavilla, pauamma, portmgr
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/blob/main/website/content/en/portmgr/charter.adoc

Description Graham Perrin freebsd_committer

2022-07-17 15:20:39 UTC

<https://www.freebsd.org/portmgr/charter/>: 

> … FreeBSD. The Ports Management Team (portmgr) is …

– then: 

> … The primary responsibility of the portmgr team is …

– that's like saying: 

    the Ports Management Team team 

Instead: 

> … The primary responsibility of portmgr is …

– or: 

> … The primary responsibility of the Team is …

Comment 1 Graham Perrin freebsd_committer

2022-07-17 15:37:30 UTC

Also, whilst there …


1) superfluous uppercase: 

> … responsibilities, The Ports Management Team may …

– should be lowercase t (the); the Ports Management Team


2) the unordered list of nine items, two of which comprise two sentences, I would:

   a) make each listing begin lowercase

   b) where there's a second sentence within a point, make it 
      a separate point with additional indent

   c) punctuate only the final listing with '.'

– compare with the style of the four-point list under <https://www.freebsd.org/portmgr/policies/#_assure_the_integrity_of_the_ports_collection>. 


All subject to approval by portmgr@ and core@

Comment 2 commit-hook freebsd_committer

2022-07-24 10:57:58 UTC

A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=6e662fa25bf3b2bff4bd07b60575b681c1748b57

commit 6e662fa25bf3b2bff4bd07b60575b681c1748b57
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-07-24 10:56:14 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-07-24 10:56:14 +0000

    Fix minor typos in portmgr charter

    PR:             265267
    Submitted by:   grahamperrin

 website/content/en/portmgr/charter.adoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

Comment 3 Sergio Carlavilla Delgado freebsd_committer

2022-07-24 14:00:12 UTC

Graham I fixed the typos.
I'm gonna close this PR.
Can you please open a review with the changes you want to make to the "specific responsibilities" list?