From owner-freebsd-doc@freebsd.org Fri Aug 10 21:37:00 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id EBA511075A4D for ; Fri, 10 Aug 2018 21:36:59 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: from mail.soaustin.net (mail.soaustin.net [18.222.6.11]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mail.soaustin.net", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 9ED0B7C0B4; Fri, 10 Aug 2018 21:36:59 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: from lonesome.com (unknown [18.188.142.31]) by mail.soaustin.net (Postfix) with ESMTPSA id 7D9D71CA0; Fri, 10 Aug 2018 21:36:58 +0000 (UTC) Date: Fri, 10 Aug 2018 21:36:57 +0000 From: Mark Linimon To: Guangyuan Yang Cc: madpilot@freebsd.org, freebsd-doc@freebsd.org Subject: translations [was: Re: The Italian translation has not been updated since 2008] Message-ID: <20180810213656.GA19279@lonesome.com> References: <018ed56d-4f1c-107b-1c58-047cd3c22fa7@FreeBSD.org> <1b890517-b2b0-efd7-9cb0-0da0241487a2@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 10 Aug 2018 21:37:00 -0000 On Fri, Aug 10, 2018 at 11:22:45AM -0400, Guangyuan Yang wrote: > Books and articles take huge amount of time and attention to details. > I cannot achieve this myself, and in my previous experience, we > definitely need some web service setting up for casual translators I know that the translation projects are a thankless task. What I'd like to discuss is where our efforts should go. I would suggest we prioritize things that work as introductions for those new to FreeBSD: - https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/index.html - https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html - https://www.freebsd.org/doc/en_US.ISO8859-1/articles/contributing/index.html and then possibly - https://www.freebsd.org/doc/en_US.ISO8859-1/articles/new-users/index.html - https://www.freebsd.org/doc/en_US.ISO8859-1/articles/mailing-list-faq/index.html IMHO the internal project documentation should not be a priority. The translations will most likely stay out of date, as they are now. Nor, do I think some of the very technical articles/books should be, for the very same reason. I think the above should be reasonable goals. What do other people think? [A separate topic would be about getting rid of antiquated documentation that is in English :-) e.g. pmake. I'll raise that elsewhere.] mcl