Page Menu
Home
FreeBSD
Search
Configure Global Search
Log In
Files
F106944467
D28179.id82322.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Flag For Later
Award Token
Size
6 KB
Referenced Files
None
Subscribers
None
D28179.id82322.diff
View Options
diff --git a/en_US.ISO8859-1/htdocs/news/status/README b/en_US.ISO8859-1/htdocs/news/status/README
--- a/en_US.ISO8859-1/htdocs/news/status/README
+++ b/en_US.ISO8859-1/htdocs/news/status/README
@@ -7,47 +7,46 @@
quarterly-submissions@FreeBSD.org
0) Timeline
+ - The months of January, April, July and October are dedicated to put
+ 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 for submissions: March 31st
- - Deadline for submissions for portmgr@ and late reports
- (a heads-up is appreciated): April 8th
+ - 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 for submissions: June 30th
- - Deadline for submissions for portmgr@ and late reports
- (a heads-up is appreciated): July 8th
+ - 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 for submissions: September 30th
- - Deadline for submissions for portmgr@ and late reports
- (a heads-up is appreciated): October 8th
+ - 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 for submissions: December 31st
- - Deadline for submissions for portmgr@ and late reports
- (a heads-up is appreciated): January 8th
-
- The months of January, April, July and October are dedicated to put together
- the reports submitted during the precedent month. This can include waiting
- for late submissions.
- Quarterly status report publication is done during the same months as soon as
- it is ready.
+ - Standard deadline: December 31st
+ - Extended deadline: January 8th
1) Call for reports
- - Send reports to the freebsd-quarterly-calls@ mailing list, to all submitters
+ - 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:
@@ -78,13 +77,13 @@
https://www.freebsd.org/news/status/report-sample.md
- 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. But it also helps to forward all the completed
+ 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 they are coming in.
- - Review and merge reports submitted via email.
+ - 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
@@ -92,7 +91,7 @@
- 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 a file named intro.md in the quarter directory.
+ - Write an introduction in a file named intro.md in the quarterly directory.
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.
@@ -102,7 +101,7 @@
- Run "make" or "make all-xml" in the quarter directory. This step needs perl
as it invokes the md2docbook perl script. Warning: md2docbook lacks some
features and likely has some bugs. Do not waste your time working on it and
- prefer manual solutions instead: once the conversion of the FreeBSD website
+ use manual editing instead: once the conversion of the FreeBSD website
to Hugo/AsciiDoctor is finished the md2docbook script will become obsolete.
- Copy the generated DocBook draft to
en_US.ISO8859-1/htdocs/news/status/report-XXXX-YY-XXXX-ZZ.xml,
@@ -119,31 +118,32 @@
- Files to edit and commit:
- In doc/en_US.ISO8859-1/htdocs/news/status/ :
- The quarterly report itself:
- report-yyyy-mm-yyyy-mm.xml
+ The quarterly report itself:
+ doc/en_US.ISO8859-1/htdocs/news/status/report-yyyy-mm-yyyy-mm.xml
- Update the next due date on the status report page and
- add a link to the new report below that:
- status.xml
+ Update the next due date on the status report page and
+ add a link to the new report below that:
+ doc/en_US.ISO8859-1/htdocs/news/status/status.xml
- In doc/share/xml/ :
- The news entry for the main website page:
- news.xml
+ The news entry for the main website page:
+ doc/share/xml/news.xml
- Sample:
+ Sample for the news entry (may need to add month):
+ <day>
+ <name>15</name>
<event>
<title>June-October 2006 Status Report</title>
- <p>The <a
- href="&enbase;/news/status/report-2006-06-2006-10.html">June to October 2006 Status Report</a>
- is now available with 49 entries.</p>
- </event>
+ <p>The <a
+ href="&enbase;/news/status/report-2006-06-2006-10.html">October to December 2020 Status Report</a>
+ is now available with 49 entries.</p>
+ </event>
+ </day>
- After the html version of the report has been built and is online, run
in the quarter directory "make all-txt" and prettify its output. This step
- needs that you have installed www/lynx and lang/perl5.30 (or other version)
- on your system.
+ requires that you have installed www/lynx and lang/perl5.30 (or newer= on
+ your system.
lynx defaults to a width of 80 and will forcibly wrap URLs to fit
within that size. The prettification process includes undoing that
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Wed, Jan 8, 8:42 PM (2 h, 27 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
15726521
Default Alt Text
D28179.id82322.diff (6 KB)
Attached To
Mode
D28179: status/README: Fix phrasing, paths, news example, and nits.
Attached
Detach File
Event Timeline
Log In to Comment