Status: 2023q3: portmgr: fixes, other changes #280
Conversation
Correctly spell Joel's surname. The collated report will be for Q3 as if it was written during (not after) the events of Q3, so 'this quarter' is Q3. Consistent use of 'this' for Q3 allows the comparison with 'last quarter' to make sense. (Logically: you can not compare last quarter with last quarter.)
Fix markup for list items (bullet points). Whilst there: tentatively create two subheadings. I suspect that one large point in isolation was originally intended to be a simple paragraph. Tentatively format phrases such as 'USES'.
Conciseness. Consistency: as pgkmgr@ was used to describe a group's work at the end of the report, so portmgr@ (with the trailing @) might be used near the beginning of the report. Tentatively use indented list items in the portmgr@ work and discussion paragraph.
This comment was marked as outdated.
This comment was marked as outdated.
http://portsmon.freebsd.org/ no longer exists, redirects to https://ports.freebsd.org/cgi/ports.cgi
This comment was marked as resolved.
This comment was marked as resolved.
| @@ -3,40 +3,47 @@ | |||
| Links: + | |||
| link:https://www.FreeBSD.org/ports/[About FreeBSD Ports] URL:link:https://www.FreeBSD.org/ports/[] + | |||
There was a problem hiding this comment.
https://ports.freebsd.org/cgi/ports.cgi?stype=faq includes a link out to https://docs.freebsd.org/en/books/handbook/ports/#ports-using, so maybe Using the Ports Collection should supersede About FreeBSD Ports.
Thoughts?
TIA
There was a problem hiding this comment.
Unless someone from portmgr replies, please leave the link as it is. It might also be that the page is planned to be changed in some near future.
'took in … for safe-keeping' (not 'took … in for safe-keeping'). Subtly better, I think.
|
@grahamperrin : Please try to finish your draft soon enough: we are already in the second half of the month and I would like to publish the status report within the month. Please try to be quick with the other coming reports. It is not needed that they are 100% perfect. As long as they are clear and grammatically correct it is fine. Writing style is an author's choice and it does not need to be improved more than what is required in https://docs.freebsd.org/en/books/fdp-primer/writing-style/ . As usual, thanks for your reviews. |
|
@lsalvadore thanks, understood. If you like, I can replace the primary link About FreeBSD Ports (removed) with FreeBSD Ports Search (targeted by the redirect), however this is so significant a change – the two pages serve quite different purposes – that IMHO a member of portmgr@ should advise. I don't want to overstep the mark. The primary link as it was before the page was removed: https://web.archive.org/web/20230915210803/https://www.freebsd.org/ports/ |
|
For clarity: this was a draft only because I thought it inappropriate to treat it as truly ready with the primary link no longer valid. Postscript, to ease comparison, PDFs of rendered pages:
|
| @@ -3,40 +3,47 @@ | |||
| Links: + | |||
| link:https://www.FreeBSD.org/ports/[About FreeBSD Ports] URL:link:https://www.FreeBSD.org/ports/[] + | |||
| link:https://docs.freebsd.org/en/articles/contributing/#ports-contributing[Contributing to Ports] URL: link:https://docs.freebsd.org/en/articles/contributing/#ports-contributing[] + | |||
| link:http://portsmon.freebsd.org/[FreeBSD Ports Monitoring] URL: link:http://portsmon.freebsd.org/[] + | |||
There was a problem hiding this comment.
I agree on removing this. Portsmon does not exist anymore and the link redirects on an already listed link.
|
@grahamperrin : Please try to revert the structural changes soon: I plan to publish the report within a few days. Thanks. |
|
If my name could get fixed that would certainly be much appreciated :D |
|
@lsalvadore can I just do a regular doc commit to fix Joel's surname? |
This comment was marked as outdated.
This comment was marked as outdated.
Aim to resolve freebsd#280 (review) Original structure (bullet points, headers etc.).
This comment was marked as outdated.
This comment was marked as outdated.
A second attempt to revert to original structure (bullet points, headers etc.).
Sure, if this is the only fix you would like to accept feel free to do such commit and then we will close this pull request. |
|
@lsalvadore I fixed @Tectu 's name in commit https://cgit.freebsd.org/doc/commit/?id=4c632833681eac361789687e1c030c4930879794 |
|
Ok, I guess we can close this PR now then. Thanks everyone. |
Correctly spell Joel's surname.
Remove FreeBSD Ports Monitoring.
Alter the URL for the tarball, based on the redirect.
About FreeBSD Ports no longer exists. Seek
portmgr@advice, then alter the URL.The collated report will be for Q3 as if it was written during (not after) the events of Q3, so 'this quarter' is Q3.
Consistent use of 'this' for Q3 allows the comparison with 'last quarter' to make sense. (Logically: you can not compare last quarter with last quarter.)
Fix, or add, markup for list items (bullet points).
Consider use of subheadings.
Other suggested changes.