Date: Mon, 2 May 2016 02:08:30 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48767 - head/en_US.ISO8859-1/htdocs/news/status Message-ID: <201605020208.u4228UTi094177@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Mon May 2 02:08:29 2016 New Revision: 48767 URL: https://svnweb.freebsd.org/changeset/doc/48767 Log: Clarify the README somewhat. Modified: head/en_US.ISO8859-1/htdocs/news/status/README Modified: head/en_US.ISO8859-1/htdocs/news/status/README ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/README Mon May 2 02:06:09 2016 (r48766) +++ head/en_US.ISO8859-1/htdocs/news/status/README Mon May 2 02:08:29 2016 (r48767) @@ -181,19 +181,43 @@ Report//EN" But should be usually the last step in the process; a good introduction can be only written once the report is considered finished. -6) Sending it out: - - After a few days, collate and commit the changes. Also update the - next due date in status.xml and link to the new report. - - Add a news entry to head/share/xml/news.xml. Template: - <event> - <title>June-October 2006 Status Report</title> + - wblock suggests that we ask different people to write introductions to + add variety. Different people will bring different viewpoints and help + keep it fresh. + +6) Committing it: + + - Files to edit and commit: + + In doc/en_US.ISO8859-1/htdocs/news/status/ : + The quarterly report itself: + 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 + + In doc/share/xml/ : + The news entry for the main website page: + news.xml + + Sample: + <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> + 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> + - Extract a text version with the command - lynx -dump -nolist report.html > report.txt and prettify it. + + /usr/local/bin/lynx -dump -nolist ./report-yyyy-mm-yyyy-mm.html \ + | /usr/bin/iconv -f ISO-8859-1 -t UTF-8 \ + | sed -e 's%Napieral/a%Napierała%g' > report.txt + + and prettify it. + lynx defaults to a width of 80 and will forcibly wrap URLs to fit within that size. The prettification process includes undoing that wrapping of URLS, and also fixing any cases where the name and email @@ -202,8 +226,17 @@ Report//EN" as the U+0142 LATIN SMALL LETTER L WITH STROKE found in trasz's surname), instead using an ASCII transliteration; these should be returned to the UTF-8 form. - - Send out To: hackers, CC: current, stable, BCC: developers. New email - to: announce@. This last one needs to be approved, so find someone - (mail postmaster) who can do that before you start. + + - Send out + To: announce@ + + 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 7) Repeat.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201605020208.u4228UTi094177>