Documentation (thread xxx of xxxxx to come)

Author Message

Jozef Baum

Wednesday 01 July 2009 4:15:09 pm

As a newbie to eZ Publish, I am continuing to spend many hours to learn eZ Publish.

In fact, it's not really about learning, but rahter about trying to solve a giant puzzle, by the lack of any good documentation to learn the complex system that eZ Publish is.

Many consider TYPO3 to be "the" enterprise level CMS. It's not. It's almost a secret that it is eZ Publish.

If eZ Publish wasn't that, always nobody would spend so much time to find out how it works. Without good documentation, even a good software doesn't go a long way.

I am sure that, more than with many other content management systems, with eZ Publish, a lot of people try to start out with it, then abandon it, only due to the lack of good documentation about how to use the system. This may be individuals wanting to publish a private home page, as well as big multinationals.

The current version is 4.1.3, but the latest available manuals are about version 4.0. And even in the technical manual about version 4.0, in the reference chapter, many items are marked as "not yet been completed".

This is sad, because for many people, this indicates an amateuristic approach, as it is the case with so many other "free" open source softwares. It's the mentality of "it's free, so take it as it is, or leave it".

In the existing technical and user manual, one cannot find any spelling error. Apparently, the authors used a spelling checker. However, the structure, as well as the expressions in English, are so bad, that one has to transform it to something meaningful.

There is not one online manual which explains how to create an eZ Publish website from scracth. Yes, reference is made to a tutorial in the old /documentation/ section. Then, when you try for instance to download the background for the TSCM website, you get the message "object not available".

All this makes really a very poor impression. I am convinced that developers at eZ Systems are very professional people, but the marketing responsibles definitely have missed some lessons while acquiring their degree.

So please, people of the eZ crew: don't take the lack of useful and good documentation to learn eZ Publish as a minor issue, because in fact, it'a a major issue. You would have very more users of eZ Publish if you had good documentation about it.

I write you this, but I'm sure many others don't write it to you, but thinks the same, and just drop eZ Publish for these reasons.

Heath

Wednesday 01 July 2009 11:25:57 pm

You wrote a good forum post.

I agree with you generally in a number of ways.

I'm not certain the plan for the documentation.

it was not covered in the roadmap recently published.

Keep studying it is possible to learn regardless of the many adversities presented by eZ

Cheers,
Heath

Brookins Consulting | http://brookinsconsulting.com/
Certified | http://auth.ez.no/certification/verify/380350
Solutions | http://projects.ez.no/users/community/brookins_consulting
eZpedia community documentation project | http://ezpedia.org

Gaetano Giunta

Thursday 02 July 2009 1:05:34 am

You might interested in the "eZ Publish 4: Enterprise Web Sites Step-by-Step" book (http://www.packtpub.com/ez-publish-4-enterprise-web-sites-step-by-step/book/rk/struts2-abr4/0609?utm_source=rk_struts2_abr4_0609&utm_medium=content&utm_campaign=ramsai).
Unfortunately you will have to wait until october...

Principal Consultant International Business
Member of the Community Project Board

Jozef Baum

Friday 03 July 2009 4:05:26 pm

Thank you, Gaetano.

If one starts out on a Monday with a simple CMS (let's say Website Baker), he knows that, on Friday, he will have developed full fledged websites with it, as far as the CMS allows for.

On the other hand, if one starts out now with eZ Publish, he knows that he will have a hard time before having a production website at the end of the year. It's a slow but certain way to go, but certainly a slow one.

So in terms of learning eZ Publish, having to wait until October is very short. And as eZ Systems has hired a doc writer, the future seams bright. It probably is worth to wait for the results of both these projects before spending many hours on finding out to what both of these resources will yield.

Powered by eZ Publish™ CMS Open Source Web Content Management. Copyright © 1999-2014 eZ Systems AS (except where otherwise noted). All rights reserved.

eZ debug

Timing: Jan 19 2025 18:59:57
Script start
Timing: Jan 19 2025 18:59:57
Module start 'layout'
Timing: Jan 19 2025 18:59:57
Module start 'content'
Timing: Jan 19 2025 18:59:58
Module end 'content'
Timing: Jan 19 2025 18:59:58
Script end

Main resources:

Total runtime1.2287 sec
Peak memory usage4,096.0000 KB
Database Queries62

Timing points:

CheckpointStart (sec)Duration (sec)Memory at start (KB)Memory used (KB)
Script start 0.00000.0053 589.2813152.6406
Module start 'layout' 0.00530.0027 741.921939.4766
Module start 'content' 0.00801.2189 781.3984594.2734
Module end 'content' 1.22690.0017 1,375.671916.1250
Script end 1.2285  1,391.7969 

Time accumulators:

 Accumulator Duration (sec) Duration (%) Count Average (sec)
Ini load
Load cache0.00340.2762160.0002
Check MTime0.00130.1078160.0001
Mysql Total
Database connection0.00060.052810.0006
Mysqli_queries1.157394.1853620.0187
Looping result0.00070.0580600.0000
Template Total1.195797.320.5979
Template load0.00230.186220.0011
Template processing1.193497.125820.5967
Template load and register function0.00030.026210.0003
states
state_id_array0.00100.078010.0010
state_identifier_array0.00240.196020.0012
Override
Cache load0.00180.1503330.0001
Sytem overhead
Fetch class attribute can translate value0.00060.051130.0002
Fetch class attribute name0.00150.120160.0002
XML
Image XML parsing0.01150.934230.0038
class_abstraction
Instantiating content class attribute0.00000.000960.0000
General
dbfile0.01251.0199230.0005
String conversion0.00000.000740.0000
Note: percentages do not add up to 100% because some accumulators overlap

Templates used to render the page:

UsageRequested templateTemplateTemplate loadedEditOverride
1node/view/full.tplfull/forum_topic.tplextension/sevenx/design/simple/override/templates/full/forum_topic.tplEdit templateOverride template
4content/datatype/view/ezxmltext.tpl<No override>extension/community_design/design/suncana/templates/content/datatype/view/ezxmltext.tplEdit templateOverride template
5content/datatype/view/ezxmltags/paragraph.tpl<No override>extension/ezwebin/design/ezwebin/templates/content/datatype/view/ezxmltags/paragraph.tplEdit templateOverride template
2content/datatype/view/ezimage.tpl<No override>extension/sevenx/design/simple/templates/content/datatype/view/ezimage.tplEdit templateOverride template
2content/datatype/view/ezxmltags/line.tpl<No override>design/standard/templates/content/datatype/view/ezxmltags/line.tplEdit templateOverride template
1print_pagelayout.tpl<No override>extension/community/design/community/templates/print_pagelayout.tplEdit templateOverride template
 Number of times templates used: 15
 Number of unique templates used: 6

Time used to render debug report: 0.0001 secs