Forums / Developer / where is database description for ez publish??

where is database description for ez publish??

Author Message

Arnoud van Steen

Wednesday 27 May 2009 3:39:50 am

<i>Quoting Felix Laate</i>
On the other hand, the code is open and actually quite readable. And the API-documentation is not bad. Not bad at all. Only a pitty thats its somewhat hidden.
<i>End Quote</i>

Please enlighten me (us?), where can I find this hidden API documentation that is not bad at all? :)

@Gaetano Giunta: Thanks for the headsup.. Its unfortunate as Ez Publish is a great platform to build on, with a lot of functionality in there and I like how it is easy to plug in extensions. If it wasnt for the lack of documentation, it would be a winner..

Paul Wilson

Wednesday 27 May 2009 3:57:17 am

@ Andre R

lol. Oh no! >Paul disappears in a puff of logic< :-)

Picking up on Felix’s comments, I’d suggest that everyone needs to pay bills and feed their kids – eZ systems, eZ crew, contributors, partners, developers, users. The best bet for each group is to help ensure the eZ ecosystem to works well for everyone – functionally and financially.

At some point, any pain or problems experienced by one group will flow on to others in some form - so it’s pretty important to take a constructive approach.

(If anyone’s interested, I jotted some thoughts on the benefits of whole process documentation and more at the start of my original documentation-contribution on RSS Import/Export, Feb 2007).

Noicokuna Niemoge

Wednesday 27 May 2009 3:59:01 am

I think the link to API docs is here:
http://pubsvn.ez.no/doxygen/4.1/html/index.html

It's referenced there:
http://ez.no/doc/ez_publish

Actually took me 10 seconds to find.

Shiki soku ze ku...

Felix Laate

Wednesday 27 May 2009 4:00:49 am

@Arnaud

You find it here: http://pubsvn.ez.no/

In my experience, whenever I cant´t find the info I need in the docs section, there's a good chance to find it here.

Publlic Relations Manager
Greater Stavanger
www.greaterstavanger.com

Arnoud van Steen

Wednesday 27 May 2009 4:06:54 am

Well yes, but thats not hidden. I've been using that of course.

Bertrand Dunogier

Wednesday 27 May 2009 4:09:54 am

By the way, if you guys find that hidden doc, just tell us, we're interested as well :)

Bertrand Dunogier
eZ Systems Engineering, Lyon
http://twitter.com/bdunogier
http://gplus.to/BertrandDunogier

zurgutt -

Thursday 28 May 2009 1:42:53 am

You mean you have LOST your docs? :D

Certified eZ developer looking for projects.
zurgutt at gg.ee

Russell Michell

Thursday 04 June 2009 3:40:12 pm

I stumbled across this thread while looking for the elusive DB schema (am installing MySQL WB right now)

Can I ask, of those of you who have run the ez DB thru MWB and have manually located and added (to "something") the table relations, would you care to share your findings?

While I have read all the posts in this thread, I may have skipped a link posted to just such a thing, so apologies for this.

On another note - while I agree with the issue of quality of documentation of template functions and the like I have to say that ez's documentation is *much* better than some other CMS's out there.

We were stuck on Plone 2 for ages and the docs for this are shocking (They may have improved in Plone 3, I haven't bothered to look) written in an inconsistent format, over many websites in a varying quality of English (No offence to non-native English speakers - really :-) - my German is pretty basic and my French..well let's not go there..I can count to 3 in Finnish though...

Compare this with ez's docs:

* On one website (two at most if you include ezpedia)
* In a consistent format
* Written at a level suitable for beginners and more experienced (subjective, but that's my own experience)
* Nicely structured and actually very detailed

I think an issue many people come up against is that they generalise over all the docs when it is on fact one or two things that are poorly documented.

Again this is just my own opinion but I wouldn't want people new to ez or considering it to be put off by reading some of the posts in this thread (howsoever factual and *objective*)

Sure, stuff can be improved, everything can, but there are ways, means and established methods for collaborating and doing this.

Just my 2c worth :-)

Cheers all,
Russ

Russell Michell, Wellington, New Zealand.
We're building! http://www.theruss.com/blog/
I'm on Twitter: http://twitter.com/therussdotcom

Believe nothing, consider everything.