Mailing-List: contact ooo-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: ooo-dev@incubator.apache.org
Received-SPF: neutral (nike.apache.org: 66.94.237.222 is neither permitted nor
 denied by domain of kay.schenk@gmail.com)
Message-ID: <4E43FF5F.1010202@gmail.com>
Date: Thu, 11 Aug 2011 09:12:15 -0700
From: Kay Schenk <kay.schenk@gmail.com>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US;
 rv:1.9.2.18) Gecko/20110616 SUSE/3.1.11 Thunderbird/3.1.11
MIME-Version: 1.0
To: ooo-dev@incubator.apache.org
Subject: [www] html instead of markdown (mdtext)?
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit

I am proposing that we adopt plain HTML for the OOo website instead of 
the current markdown (mdtext) implementation.

I hesitate to make this recommendation given ALL the time and research 
Dave and others have already spent on the current incubator website, 
but, I feel, given that we will be migrating a rather large existing 
site, it makes sense.

I also realize that doing this will "break" the ability to use the 
webgui editing capability of the Apache CMS, forcing everyone to use svn 
for page updates. However, I don't have a good feel right now for the 
ultimate impact of that -- e.g. what do we expect in terms of web site 
editors.

This would allow us to continue to use the default template system 
(Dotiac::DTL) but eliminate the need for wrapping or intermixing 
markdown text with normal HTML. HTML files shouldn't require any 
"wrapping" functions at all I think, since this is the indigenous format 
for web servers. We would have to bypass header, footer and navigation 
items for anything that *isn't* html, like js, css files.

Unfortunately, I've had a very difficult time this week trying to find 
any information on the setup details of Dotiac::DTL (documentation not 
available) -- the relationship of the two .pm files to the template 
areas, etc.

I took at look around at many the Apache web areas (svn) at:

http://svn.apache.org/repos/asf/

You will see, as I did, that the vast majority are not using markdown, 
and this is NOT a requirement.

Anyway, thoughts/comments on this proposal?
-- 
------------------------------------------------------------------------
MzK

"Those who love deeply never grow old;
  they may die of old age, but they die young."
                         -- Sir Arthur Pinero