From owner-svn-doc-head@freebsd.org Sun Jul 12 01:28:54 2015 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 152149026; Sun, 12 Jul 2015 01:28:54 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2001:1900:2254:2068::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 E9A421860; Sun, 12 Jul 2015 01:28:53 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.70]) by repo.freebsd.org (8.14.9/8.14.9) with ESMTP id t6C1Sr5f040722; Sun, 12 Jul 2015 01:28:53 GMT (envelope-from wblock@FreeBSD.org) Received: (from wblock@localhost) by repo.freebsd.org (8.14.9/8.14.9/Submit) id t6C1SrD0040721; Sun, 12 Jul 2015 01:28:53 GMT (envelope-from wblock@FreeBSD.org) Message-Id: <201507120128.t6C1SrD0040721@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: wblock set sender to wblock@FreeBSD.org using -f From: Warren Block Date: Sun, 12 Jul 2015 01:28:53 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46950 - 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.20 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: Sun, 12 Jul 2015 01:28:54 -0000 Author: wblock Date: Sun Jul 12 01:28:52 2015 New Revision: 46950 URL: https://svnweb.freebsd.org/changeset/doc/46950 Log: Add documentation entries for the second quarter status report. Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2015-04-2015-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2015-04-2015-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2015-04-2015-06.xml Sat Jul 11 17:07:10 2015 (r46949) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2015-04-2015-06.xml Sun Jul 12 01:28:52 2015 (r46950) @@ -83,4 +83,108 @@ Miscellaneous + + New Documentation Committers + + + &os; Documentation Engineering Team + doceng@FreeBSD.org + + + + &os; Porter's Handbook + &os; Web Site + &os; Foundation Web Site + + + +

Two new documentation committers were added to the team in + the second quarter of 2015.

+ +

Mathieu Arnold is a member of the &os; Ports Management Team. + Over the past year, he has worked on many large and complex + updates to keep the Porter's Handbook current, and + continues to update this important document.

+ +

Anne Dickison is Marketing Director for the &os; Foundation. + She will focus on updating and improving the &os; main web + site.

+ +

We welcome both new committers and look forward to their + contributions!

+ + + + + Documentation Working Group at BSDCan + + + &os; Documentation Team + freebsd-doc@FreeBSD.org + + + + BSDCan + reStructured Text + Markdown + AsciiDoc + &os; Wiki + &os; Web Site + Annotator + Annotator Backend Stores + + + +

During the Developer Summit held in the two days before + BSDCan, a documentation working group meeting was held. We + discussed some of the biggest opportunities available to the + documentation team.

+ +

Modernizing our translation system was, again, a major topic. + Making it easier for translators to do their work is vitally + important. Translations make &os; much more accessible for + non-English speakers, and those people and the translators + themselves often become valuable technical contributors in + other areas. Progress was made in this area, and we hope to + have more news soon.

+ +

Methods of making it easier for people to contribute to + documentation was another major topic. At present, we use + DocBook XML for articles and books, and mdoc(7) for man pages. + These markup languages are not very welcoming for new users. + There are simpler documentation markup languages like RST, + Markdown, and AsciiDoc that take less time to learn and use. + In fact, these markup systems are all similar to each other. + These systems tend to be more oriented towards visual + appearance rather than the semantic markup of our present + systems, there might be ways to work around that.

+ +

Following the theme of making contributing easier, we also + discussed giving easier access so users can make additions to + the &os; Wiki. Like any other useful web resource, it was + horribly abused by spammers and access was limited to prevent + that abuse. It is tricky to allow submissions yet keep the + quality of submitted information usefully high.

+ +

Due to the markup systems used, it is difficult to review + documents for the quality of their information. Annotator is + a Javascript system that allows adding notes to an existing + web page. This would allow us to hold content-only reviews of + documentation web pages. Reviewers would not see markup, so + they could concentrate only on whether the information was + accurate and complete. To use this as desired, we need some + help with ports and testing.

+ + + + +

Complete a port for the backend storage component of + Annotator. Preferably this would be the lowest overhead and + most open-licensed version available. Assistance from those + familiar with Python and Javascript web development is + welcome.

+ + + +