Forums / Suggestions / "Hello World" Documentation

"Hello World" Documentation

Author Message

Robert Castelo

Wednesday 20 August 2003 7:33:47 am

First off, let me say that I think the documentation that exists for EzPublish is good, and seems to be getting better all the time.

However, there is a serious gap that will just defeat most users, and no matter how well designed EzPublish is, and what great features it has, most users will give up on it and move on.

What is missing is a good Getting Started article. Once a user has installed EzPublish, and looked at the Demo, they will want to start making their own site - but were do they start?

It would be really useful to have an article that starts users off creating their own site, a "Hello World" site. Once a user is getting on with this, they can read up on EzPublish features and learn them by applying them.

At the moment the EzPublish documentation is a good reference source that explains variables, objects, classes, etc. - but it is difficult to see were to begin. I feel like I have to read ALL the documentation before I can even start to make a single page!

Hope someone at EzPublish takes note of this, and writes a good article!

Bård Farstad

Wednesday 20 August 2003 8:38:20 am

Noted, you can expect this in the near future.

--bård

Documentation: http://ez.no/doc

Alexandre Cunha

Wednesday 20 August 2003 9:29:51 am

Hi Robert,

I full agree with you, but i thing the community need contribute a litle more. Not just the Ez crew.

Looking the community stats (http://ez.no/developer/community_stats), the majority of the contributions in documentation, come from Ez crew.

I think that this should change for a bigger participation from the community.

my 2 cents

axel

http://AlexandreCunha.com

Robert Castelo

Wednesday 20 August 2003 12:54:25 pm

Do those statistics include the WIKI?

http://ezwiki.blanko.info/

The community seems to be more active there than on the Documentation section here.

By the way, I found this article about EzPublish on Sitepoint that is a good example of a Getting Started guide:

http://www.sitepoint.com/article/1208/1

Thank you for the feedback Bård - and an excellent product.

Bård Farstad

Wednesday 20 August 2003 1:06:51 pm

Robert, the the wiki documentation has been merged with the documentation on ez.no. The new documentation on ez.no is also wiki style so any registered user may edit it.

--bård

Documentation: http://ez.no/doc