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.
+
+
+
+
From owner-svn-doc-head@freebsd.org Sun Jul 12 03:54:51 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 4A3C99FD9;
Sun, 12 Jul 2015 03:54:51 +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 3B06C1AF4;
Sun, 12 Jul 2015 03:54:51 +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 t6C3sp8d016254;
Sun, 12 Jul 2015 03:54:51 GMT (envelope-from wblock@FreeBSD.org)
Received: (from wblock@localhost)
by repo.freebsd.org (8.14.9/8.14.9/Submit) id t6C3spF9016253;
Sun, 12 Jul 2015 03:54:51 GMT (envelope-from wblock@FreeBSD.org)
Message-Id: <201507120354.t6C3spF9016253@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 03:54:51 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
svn-doc-head@freebsd.org
Subject: svn commit: r46951 - 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 03:54:51 -0000
Author: wblock
Date: Sun Jul 12 03:54:50 2015
New Revision: 46951
URL: https://svnweb.freebsd.org/changeset/doc/46951
Log:
Try to emphasize that the new doc committers have already contributed.
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 Sun Jul 12 01:28:52 2015 (r46950)
+++ head/en_US.ISO8859-1/htdocs/news/status/report-2015-04-2015-06.xml Sun Jul 12 03:54:50 2015 (r46951)
@@ -111,7 +111,7 @@
site.
We welcome both new committers and look forward to their
- contributions!
+ additional contributions!