From dev-return-34104-apmail-harmony-dev-archive=harmony.apache.org@harmony.apache.org Wed May 14 09:18:39 2008 Return-Path: Delivered-To: apmail-harmony-dev-archive@www.apache.org Received: (qmail 89576 invoked from network); 14 May 2008 09:18:39 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 14 May 2008 09:18:39 -0000 Received: (qmail 4314 invoked by uid 500); 14 May 2008 09:18:38 -0000 Delivered-To: apmail-harmony-dev-archive@harmony.apache.org Received: (qmail 4278 invoked by uid 500); 14 May 2008 09:18:38 -0000 Mailing-List: contact dev-help@harmony.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@harmony.apache.org Delivered-To: mailing list dev@harmony.apache.org Received: (qmail 4267 invoked by uid 99); 14 May 2008 09:18:38 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 14 May 2008 02:18:38 -0700 X-ASF-Spam-Status: No, hits=2.0 required=10.0 tests=HTML_MESSAGE,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of nad.morozova@googlemail.com designates 209.85.198.245 as permitted sender) Received: from [209.85.198.245] (HELO rv-out-0708.google.com) (209.85.198.245) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 14 May 2008 09:17:49 +0000 Received: by rv-out-0708.google.com with SMTP id k29so3443970rvb.0 for ; Wed, 14 May 2008 02:18:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:references; bh=Qb9CLLNx6RL/KJQpi1jBuzjbrSKarQY6+RVF9YWHsLY=; b=aQm7+zm7FRfdDmCfaOberPHAn/ntkyjEU8eXgm+5yy4fzcMNgC9/AlXKj8GnDt9ZmHpV+bNRax+CUmTki0arkxxJSzG0ADbyz7VDFlBlkzj63ThqT1J7RT8WkQqCdh3UQ32fkjEnWEDPty5TFZ1fVC2j7fO7h08uFCTJMK89kZA= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:to:subject:in-reply-to:mime-version:content-type:references; b=HxR8CUfRScziGEAgSmbKJZlqIR/wFeZA8DH3PKoczjNpsafDJ9BQjlDsNQCzyhPs8RTlkqIwmj6g228HXXyn/YP3fh5zqsKyESJC4X3SwUIGZT86YhbkVWqE8G9To5uK3p9GjcrTIXAVCL5w8Ihc22ezjvyUpId0RNguxtK3yBQ= Received: by 10.141.3.17 with SMTP id f17mr366426rvi.180.1210756684342; Wed, 14 May 2008 02:18:04 -0700 (PDT) Received: by 10.141.116.15 with HTTP; Wed, 14 May 2008 02:18:04 -0700 (PDT) Message-ID: Date: Wed, 14 May 2008 13:18:04 +0400 From: "Nadya Morozova" To: dev@harmony.apache.org Subject: Re: [doc] Re: svn commit: r655779 [1/2] - in /harmony/standard/site: docs/ docs/subcomponents/drlvm/ xdocs/ xdocs/subcomponents/drlvm/ In-Reply-To: MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_3279_14780703.1210756684327" References: <20080513083213.2892C23889C4@eris.apache.org> <200805131016.m4DAG5pk012731@d12av02.megacenter.de.ibm.com> <5ce835490805130514g71358676i7c1716bc946fc964@mail.gmail.com> X-Virus-Checked: Checked by ClamAV on apache.org ------=_Part_3279_14780703.1210756684327 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Content-Disposition: inline Hi, A small clarification: There are two ways to add new content, both reside in xdocs. 1) write all you have to say in an HTML file, then write a simple XML file to wrap it up. 2) writer in XML directly Historically, we used the first approach with longer docs because they're easier to edit with free HTML editors, than XML content + those docs often came with code contributions, and could act as standalone documents. Now I guess every author decides what's best for them. On Wed, May 14, 2008 at 12:13 AM, Mark Hindess wrote: > > I was missing something. Ilya, thanks for enlightening me. > -Mark. > > In message <5ce835490805130514g71358676i7c1716bc946fc964@mail.gmail.com>, > "Ilya > Berezhniuk" writes: > > > > Mark, > > > > AFAIU, .xml files in xdocs contain some info for building the page > > into the whole site, but major part of .xml is a simple HTML written > > with different mark-up. > > > > So the change you see in this commit is a combination of small .xml > > with required service info, and .html included using . > > Both these files will turn into single .html in 'docs'; as I > > understand, the result after anakia processing is almost the same as > > for single .xml. > > > > Another reason is existing HTML document - for example, > > "NCAI_spec.html" is a slightly modified copy of > > "vm/vmcore/src/ncai/NCAI.html". > > > > Thanks, > > Ilya. > > > > > > 2008/5/13, Mark Hindess : > > > > > > In message <20080513083213.2892C23889C4@eris.apache.org>, > gshimansky@apach > > e.org > > > writes: > > > > > > > > > > > Author: gshimansky > > > > Date: Tue May 13 01:32:11 2008 > > > > New Revision: 655779 > > > > > > > > URL: http://svn.apache.org/viewvc?rev=655779&view=rev > > > > Log: > > > > Applied patch from HARMONY-5812 > > > > [site][doc] NCAI site documentation > > > > > > > > > > > > Added: > > > > harmony/standard/site/docs/subcomponents/drlvm/NCAI.html (with > props > > ) > > > > harmony/standard/site/docs/subcomponents/drlvm/NCAI_spec.html > (with > > props) > > > > harmony/standard/site/xdocs/subcomponents/drlvm/NCAI.html (with > prop > > s) > > > > harmony/standard/site/xdocs/subcomponents/drlvm/NCAI.xml (with > props > > ) > > > > harmony/standard/site/xdocs/subcomponents/drlvm/NCAI_spec.html > (with > > props) > > > > harmony/standard/site/xdocs/subcomponents/drlvm/NCAI_spec.xml > (with > > props) > > > > > > > > > I might be missing something but I assume checking in the .html files > > > in the xdocs tree is a mistake and that only the .xml files are > required > > > in xdocs and .html only in docs? > > > > > > > > > -Mark. > > > > > > > > > > > > > > -- Cheers, Nadya ------=_Part_3279_14780703.1210756684327--