Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 40A5F200B75 for ; Sun, 21 Aug 2016 08:03:03 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 3447F160ABE; Sun, 21 Aug 2016 06:03:03 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 79932160ABB for ; Sun, 21 Aug 2016 08:03:02 +0200 (CEST) Received: (qmail 488 invoked by uid 500); 21 Aug 2016 06:03:01 -0000 Mailing-List: contact dev-help@ofbiz.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ofbiz.apache.org Delivered-To: mailing list dev@ofbiz.apache.org Received: (qmail 477 invoked by uid 99); 21 Aug 2016 06:03:00 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd3-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 21 Aug 2016 06:03:00 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd3-us-west.apache.org (ASF Mail Server at spamd3-us-west.apache.org) with ESMTP id 3FB961800A3 for ; Sun, 21 Aug 2016 06:03:00 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd3-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: 2.299 X-Spam-Level: ** X-Spam-Status: No, score=2.299 tagged_above=-999 required=6.31 tests=[HTML_MESSAGE=2, KAM_LAZY_DOMAIN_SECURITY=1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001] autolearn=disabled Received: from mx1-lw-us.apache.org ([10.40.0.8]) by localhost (spamd3-us-west.apache.org [10.40.0.10]) (amavisd-new, port 10024) with ESMTP id CrW_kxTVBUTI for ; Sun, 21 Aug 2016 06:02:58 +0000 (UTC) Received: from smtp26.services.sfr.fr (smtp26.services.sfr.fr [93.17.128.163]) by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with ESMTPS id 301225F295 for ; Sun, 21 Aug 2016 06:02:58 +0000 (UTC) Received: from [192.168.1.2] (250.222.130.77.rev.sfr.net [77.130.222.250]) by msfrf2603.sfr.fr (SMTP Server) with ESMTP id 71C361C000802 for ; Sun, 21 Aug 2016 08:02:50 +0200 (CEST) Received: from [192.168.1.2] (250.222.130.77.rev.sfr.net [77.130.222.250]) (Authenticated sender: jacques.leroux60@sfr.fr) by msfrf2603.sfr.fr (SMTP Server) with ESMTPA for ; Sun, 21 Aug 2016 08:02:50 +0200 (CEST) Authentication-Results: sfr.fr; auth=pass (PLAIN) smtp.auth=jacques.leroux60@sfr.fr Subject: Re: Sharing the burden of maintaining documentation Reply-To: dev@ofbiz.apache.org References: <513c4612-0528-df6c-ad5f-055591624b67@les7arts.com> To: dev@ofbiz.apache.org From: Jacques Le Roux Organization: Les Arts Informatiques Message-ID: Date: Sun, 21 Aug 2016 08:02:52 +0200 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0 MIME-Version: 1.0 In-Reply-To: <513c4612-0528-df6c-ad5f-055591624b67@les7arts.com> X-sfr-mailing: LEGIT Content-Type: multipart/alternative; boundary=------------EE5EA063EC55FCE01B7EC21A archived-at: Sun, 21 Aug 2016 06:03:03 -0000 --------------EE5EA063EC55FCE01B7EC21A Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Le 20/08/2016 à 21:15, Jacques Le Roux a écrit : >> - Provide full documentation through a powerful publishing solution such as >> DocBook or DITA. > > +1, but we need to have a consensus with the tool, Paul and I advocated for instance Err, forgot "AsciiDoc" in this sentence :/ Note: there are AsciiDoc plugins for Eclipse and IntelliJ. With Pandoc you can transform almost all formats to another Interesting contradictory PoV on DITA http://idratherbewriting.com/2015/01/28/10-reasons-for-moving-away-from-dita/ Jacques --------------EE5EA063EC55FCE01B7EC21A--