Re: Re: Just Getting Started

Am 18.10.2002 10:03 Uhr +0100 uebermittelte Alex McLintock folgende Zeilen:
>At 10:34 16/10/02, Juergen wrote:
>>Hi Jason
>>
>>It's a good idea! In August, I have also started a documentation
>>concerning creating a new pub.
>>Check following mailing lists entries:
>>http://mail.wyona.org/pipermail/wyonacms-users/2002-August/000111.html
>>http://mail.wyona.org/pipermail/wyonacms-users/2002-August/000119.html
>
>
>Ok,
>
>here are my comments on this document. Please note that these are 
>all meant to be constructive criticism, and I am quite willing to 
>help with the documentation. I *haven't* built a live Wyona site yet 
>because of the lack of documentation.

Hi Alex, hi list,

seem's like we both share the same problem: I haven't built a wyona 
based site either. Everytime I start playing around with it, it 
doesn't take long until I'm terribly lost and / or frustrated. Most 
of the time it is is because of my lack of knowledge. And you need 
quite some knowledge and understanding to get something with wyona up 
and running (you name it below): XML (an easy one), XSLT (not that 
easy, but somehow managable) and Cocoon (facinating, but quite 
demanding). After analysing my "failures" I decided to take a deeper 
look at Cocoon and XSLT, before trying again Wyona. Actually I'm 
reading the book by Matthew Langham  & Carsten Ziegeler (Cocoon: 
Building XML Applications; very good one!)  and play around with 
Cocoon. This brought up the idea, that maybe some easy - but 
descripited - examples using Coccon could be of any help for 
beginners. What do you think about that?

Markus

>
>
>Basically you've assumed far too much for any kind of tutorial. Each 
>and every action you go through needs an explanation otherwise it is 
>useless. I suppose you probably meant to put it in later, but lets 
>do it now.
>
>Explain what eth-mat is, and why you would want to copy it.
>
>In fact *do* we want new users to copy eth-mat or wouldn't it be 
>better to create a simple demo site ourselves for inclusion in the 
>Wyona distribution? That way new users can jump straight in at Item 
>9 and skip all this stuff.
>
>
>Briefly list pre-requisite knowledge: XML, XSLT, *Cocoon*, and where 
>to find out more about those topics.
>
>Item 2) Why call the directory standard/t01 ? if there is a reason 
>say so, if not, say that too.
>Item 3) Explain that you *need* to modify the sitemap to take into 
>account the new directory (or URL path).
>Item 4) Why does using the html-editor require recompilation of a 
>java class? this is a dire mistake and should be corrected ASAP. 
>(Yes I know: "Well volunteered Alex"). How does one use more than 
>one html-editor if the directory is hardcoded into the class?
>Item 5) Explain how the sitemaps are in fact a tree of sitemaps with 
>the root linking to its children, and so on.
>Item 6) Why is the Configuration directory the only one to start 
>with a capital C ?
>item 7) Explain that this file is Wyona's config file.
>Item 8.1) What? Didn't know you could do this with JTidy. In fact 
>what is it doing?
>Item 8.2) What is this ? What is this XSP for?
>Item 8.3) Ditto.
>Item 8.4) Do we *have* to have so many sitemaps? I would much prefer 
>to use fewer sitemaps since they take up so much memory.
>
>
>Alex
>
>
>
>
>
>Openweb Analysts Ltd, London.
>Software For Complex Websites http://www.OWAL.co.uk/
>Open Source Software Companies please register here 
>http://www.OWAL.co.uk/oss_support/
>
>
>_______________________________________________
>WyonaCMS-users mailing list
>[email protected]
>http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-users


-- 
**************************************

Unglaublich, aber wahr: Dilbert lebt!

**************************************