From owner-svn-doc-head@freebsd.org Mon May 2 02:08:31 2016 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 351ECB2999B; Mon, 2 May 2016 02:08:31 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id EBC671A21; Mon, 2 May 2016 02:08:30 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id u4228UdU094178; Mon, 2 May 2016 02:08:30 GMT (envelope-from wblock@FreeBSD.org) Received: (from wblock@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id u4228UTi094177; Mon, 2 May 2016 02:08:30 GMT (envelope-from wblock@FreeBSD.org) Message-Id: <201605020208.u4228UTi094177@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: wblock set sender to wblock@FreeBSD.org using -f From: Warren Block Date: Mon, 2 May 2016 02:08:30 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 May 2016 02:08:31 -0000 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: - - June-October 2006 Status Report + - 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: + + June-October 2006 Status Report

The June to October 2006 Status Report - is now available with 49 entries.

+ href="&enbase;/news/status/report-2006-06-2006-10.html">June to October 2006 Status Report + is now available with 49 entries.

 + - 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.