diff --git a/en_US.ISO8859-1/htdocs/news/status/README b/en_US.ISO8859-1/htdocs/news/status/README index 936a6bc8f0..0c2075e9d6 100644 --- a/en_US.ISO8859-1/htdocs/news/status/README +++ b/en_US.ISO8859-1/htdocs/news/status/README @@ -23,9 +23,9 @@ Compiling status reports - best practices (secretary@asiabsdcon.org) March. Our readers seem to value these reports, so we should try to get them in if at all possible. -4) Putting it all together: - - Copy and paste all reports in a single .xml file and use tidy(1) to get - it well formatted. Usually <url>s without a description are missing +4) Building the report: + - Accumulate the received reports in a single .xml file and use tidy(1) to + get them well-formatted. Usually <url>s without a description are missing the closing "/>" which is the cause for most of the errors you will encounter. Sometimes other closing tags are missing. - Invoking tidy with the following options seems to cause the fewest @@ -43,6 +43,10 @@ Compiling status reports - best practices <li>some item</li> </ul> <p>Some more blabla ... + - Review and commit the reports immediately as they are coming in. Hook the + resulting XML to the build for the first time but do not link to it from + anywhere. This gives time for other committers to review and suggest + minor changes. 5) After a couple of iterations of the above, wrap the whole thing in a report template: @@ -136,9 +140,10 @@ Report//EN" the html helps. Make sure you have an up-to-date doc tree. 6) Sending it out: - - Commit, hooking the report XML to the build but not linking to it - from anywhere. This gives time for other committers to review and - suggest minor changes. + - Explicitly mail all the submitters (in BCC:) with the link pointing to + the HTML version of the prepared report so they could check their + entries before publication. It is wise to set an exact deadline for + this, in order to avoid late comments. - 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: