W3C home > Mailing lists > Public > www-amaya-doc@w3.org > February 2010

Re: Doc on "How To Build A Webpage" in Amaya?

From: Charles McCathieNevile <chaals@opera.com>
Date: Sun, 21 Feb 2010 20:45:11 +0100
To: "Patrick Grayson" <pat.grayson@gmail.com>, www-amaya-doc@w3.org
Message-ID: <op.u8hs5lvxwxe0ny@widsith.eng.oslo.osa>
On Sun, 10 Jan 2010 21:49:30 +0100, Patrick Grayson  
<pat.grayson@gmail.com> wrote:

> Does anyone have a basic document on "How To Build A Webpage" in Amaya?  
> The FAQ is not that helpful.

I actually wrote some stuff on this about a decade ago. It didn't explain  
"How to build a webpage" so much as what are the things I can put in a web  
page, with pointers back through the manual on how to use them. It's still  
there in the latest documentation, at the end of the index as  
"introduction to HTML" - and it is still not very good. But Amaya being  
Open source, improving the documentation is a contribution that people  
could make.

Alternately, if people explain the questions they had that the  
documentation doesn't answer, it might help other people think about  
proposing improvements to the documentation itself.

For example, the current listing of contents in the Manual is hard to  
understand at a glance. Adding a few top-level headings to break it up  
into something like

Browsing
   Moving, selecting, etc.
   Accessibility, configuring shortcuts
Editing
   Basics
     Creating/Opening, saving documents (part 1)
     Editing elements, attributes, text
     Working from Templates
   Using HTML features
     Links
     Tables
     Image Maps
     Document types
   Style and layout (CSS)
   Mathematics - MathML
   SVG - advanced Graphics
   XML - advanced structures
Working with Documents
   Creating Templates
   Publishing, WebDAV
   Printing

Would seem (to me) to give a bit more clarity, without even touching the  
existing material. If we use this list to propose concrete changes, and  
people generally agree that they are improvements, it is possible to make  
them part of the distribution package of Amaya...

cheers

Chaals

-- 
Charles McCathieNevile  Opera Software, Standards Group
     je parle français -- hablo español -- jeg lærer norsk
http://my.opera.com/chaals       Try Opera: http://www.opera.com
Received on Sunday, 21 February 2010 19:45:49 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 19:48:14 UTC