This repository has been archived by the owner on Mar 1, 2023. It is now read-only.
README.adoc: early preparations for 2022q4 #535
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Whilst here: AsciiDoc tidiness, and more, including: * awareness of freebsd-announce * attention to order and heading levels * clearer presentation of dates. "Immediately after the end of the quarter" will be 1st January 2023 (not the last day of the third month within the quarter).
grahamperrin
commented
Oct 14, 2022
The word 'time' is superfluous. Current time period, current period.
lsalvadore
suggested changes
Oct 15, 2022
The related request for changes: <freebsd#535 (review)>. Comments from @lsalvadore answered some underlying questions, which I had not raised, there's now a very clear picture of what is (or should be) routine. This commit: * reorders things slightly * makes some lines/sentences a little shorter * aims to make the numbered steps, for submission, a little easier to digest, at a glance * drops a hint to allow edits from maintainers. The reorder, in a nutshell: 1. begin with emphasis on acting early 2. next, be free from worries (the offer of corrections to drafts) 3. add a section for reviewing 3. demote lateness to the end of a section (no longer mixed with the general blurb – lateness should be exceptional, not general).
grahamperrin
commented
Oct 15, 2022
lsalvadore
reviewed
Oct 16, 2022
Aim to resolve the conversation with @lsalvadore at <freebsd#535 (comment)>. Looking ahead: FreeBSD Status Reports <https://www.freebsd.org/status/> might benefit from some kind of definition of the team. For now: revert to a single sentence, not a bullet point, that specifies an e-mail address.
|
@lsalvadore please: was request #535 (review) fulfilled? |
grahamperrin
added a commit
to grahamperrin/freebsd-quarterly
that referenced
this pull request
Oct 22, 2022
Late changes, so feel to reject all suggestions. This pull request dovetails with the conversation at <freebsd#535 (review)> about possible methods of contacting the team, or individual members. Link to the main FreeBSD Status Reports page, which is not directly available through the current sidebar (it's indirectly through the News link). Whilst here: maybe also link to last quarter's report. Without something (first) 'on one hand', there should be nothing 'on the other hand'. The phrase 'quarterly team' is a little ambiguous. Better: 'status report team' (or 'quarterly status report team') in the sign-off.
|
Yes, everything is fine, thanks @grahamperrin. I am about to try to address issue #324 about merging this repository into the FreeBSD doc repository, which is an important step to improve our workflow (having the reports in this repository for reviewing and in the FreeBSD doc repository for publication is annoying for many reasons). Thus, I would like that this was the last modification to README.adoc before the repository merging (assuming we really do it) and to postpone future changes to the future corresponding file in the doc repository. So if you have any more improvements to suggest for it, wait a bit for them please. For the same reason, I refrain to create the 2022q4 directory for now. This might be the first quarter for which reports will be merged directly in the doc repository (thus no more commits such as 4b8255e). |
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Whilst here, AsciiDoc tidiness, and more, including:
Note, "immediately after the end of the quarter" will be 1st January 2023 (not the last day of the third month within the quarter).
There's not yet a 2022q4 folder, it'll appear (with a Makefile) in due course.