diff --git a/website/content/en/status/README b/website/content/en/status/README index b0a71e26c3..b0a554d16d 100644 --- a/website/content/en/status/README +++ b/website/content/en/status/README @@ -1,151 +1,151 @@ Compiling status reports - best practices Quarterly status reports git repository: https://github.com/freebsd/freebsd-quarterly E-mail address for report submissions: quarterly-submissions@FreeBSD.org 0) Timeline - The months of January, April, July and October are dedicated to putting together the reports submitted during the precedent month. This can include waiting for late submissions. - portmgr@ entries default to the extended headline, because of the overlap between quarterly reports and quarterly ports branches. - All entries can have the deadline extended by emailing quarterly-submissions@ up until the extended deadline. - Quarterly status report publication is done during the same months as soon as the report is ready. - First Quarter: - First call for reports: March 1st - 2 weeks left reminder: March 15th - Last reminder: March 24th - Standard deadline: March 31st - Extended deadline: April 8th - Second Quarter: - First call for reports: June 1st - 2 weeks left reminder: June 15th - Last reminder: June 24th - Standard deadline: June 30th - Extended deadline: July 8th - Third Quarter: - First call for reports: September 1st - 2 weeks left reminder: September 15th - Last reminder: September 24th - Standard deadline: September 30th - Extended deadline: October 8th - Fourth Quarter: - First call for reports: December 1st - 2 weeks left reminder: December 15th - Last reminder: December 24th - Standard deadline: December 31st - Extended deadline: January 8th 1) Call for reports - Send calls to the freebsd-quarterly-calls@ mailing list, to all submitters of last quarterly status reports (they may have updates or further improvements), and, depending on the season: - Various conference organizers: - AsiaBSDCon (secretary@asiabsdcon.org) March (First Quarter); - BSDCan (info@bsdcan.org) May (Second Quarter); - EuroBSDcon September - October (Third-Fourth Quarter). EuroBSDcon as an organization is not interested in writing reports for FreeBSD (at least it was not in October 2019: its reason is that the conference is not FreeBSD specific), so reports about this event should be asked of members of the FreeBSD community that attended it; - Google Summer of Code students and their mentors: soc-students@ and soc-mentors@ (Second and Third Quarter). - The easiest way to send calls for quarterly status reports is to use the sendcalls perl script in the tools directory of the git repository. It can also be used through a cron job, for example: - 0 0 1,15,24 3,6,9,12 * cd ~/freebsd-quarterly/tools && ./sendcalls -s 'Daniel Ebdrup Jensen' + 0 0 1,15,24 3,6,9,12 * cd ~/freebsd-quarterly/tools && ./sendcalls -s 'Lorenzo Salvadore' If you are indeed using a cron job, please run it on freefall and sign it with your name so that it is possible to infer who has configured the cronjob, in case something goes wrong. The script automatically sends calls to freebsd-quarterly-calls@, last quarter submitters and other recipients depending on the season. - It may also be worth making a call for reports on the forums as was done here: https://forums.freebsd.org/threads/call-for-freebsd-2014q4-october-december-status-reports.49812/ - The AsciiDoctor template is at: https://www.freebsd.org/news/status/report-sample.adoc - Reporting howto is at: https://www.freebsd.org/news/status/howto.html. It contains a great deal of useful hints for the submitters on how to write good reports. It also helps to forward all the completed reports to developers for reference, and point to the latest report in the CFR. 2) Building the report: - Review and merge pull requests as well as those submitted via email, as they come in. - For each newly merged report, add its filename to the local Makefile: put it in the variable corresponding to the section where you want the report to appear. Sort the variables content as you want to sort the reports in the corresponding section. - While the reports are being updated, other doc-committers (wblock, pluknet, and bjk, for example) may review the individual entries and propose fixes. - Write an introduction in the _index.adoc file. It should be usually the last step in the process; a good introduction can be only written once all the reports have been collected. - theraven may be poked for composing a nice introduction for the reports. wblock suggests that we ask different people to write introductions to add variety. Different people will bring different viewpoints and help keep it fresh. - Once all the reports have come in, make any final adjustments and copy the contents of the directory to doc/website/content/en/status/report-yyyy-mm-yyyy-mm/ 3) Committing it: - Files to edit and commit: The quarterly report itself, found in: doc/website/content/en/status/report-yyyy-mm-yyyy-mm/ Update the next due date on the status report page and add a link to the new report below that: doc/website/content/en/status/_index.adoc The news entry for the main website page: doc/website/data/en/news/news.toml Sample for the news entry (may need to add month): [[news]] date = "2021-01-16" title = "October-December 2020 Status Report" description = "The October to December 2020 Status Report is now available with 42 entries." - After the html version of the report has been built and is online, use w3m to dump the website as plain-text, something like the following: w3m -cols 80 -dump https://www.freebsd.org/status/report-2021-01-2021-03/ > /tmp/report-2021-01-2021-03.txt w3m has full proper unicode support, and as w3m(1) explains, -dump simply outputs text rendering of the html that can then have a few elements snipped, while -cols ensures that everything is wrapped to 80 columns. - Send out To: announce@ Subject: FreeBSD Quarterly Status Report - Quarter This one must be approved, so find someone (mail postmaster) who can do that before starting. Send a separate mail: To: hackers CC: current, stable BCC: developers Note: Remember to toggle disposition (attachment or inlining), as well as recoding in the MUA. 4) Repeat.