Quote from: smashingred at Nov 05, 2006, 12:42 PMMy personal opinion is that the documentation must be done in conjunction with every version regardless of the version The wiki is painful as are the forums for documentation because there seems to be little or no organization.
Don’t you think your judgment is a little harsh (or quick) there ?
The wiki is fairly new (a few weeks) and under construction, and I have no doubt in time it will become a valuable resource to MODx users. It’s meant to enable everyone to contribute to the documentation effort, and in time improve the existing online documentation.
As for the forums, it’s not meant for documenting MODx (thought you’ll find some pretty helpful bits in the forums, the Tips and tricks board comes to mind). Forums are there for support, and I think the MODx forums are not only very friendly but boast a pretty fast response time and rarely if ever do I recall someone being left stuck with a problem no matter how singular it is. Of course, there are always corner case issues but those are usually adressed through the bug tracker and solved at some point.
Quote from: smashingredI don’t ike scouring forums for usage info. I don’t ming scouring them for troubleshooting but how to use a module, plugin or snippet should be documented in a document format.
And I agree with you there.
Yet, I am not sure I understand this since at least 90% of MODx resources *are* already documented.
Snippets usually include : a sample call, a list of available parameters, when needed : requirements and cache directives (some snippet have to be called cached or uncached to work).
Plugins usually include : a list of system events you need to configure the plugin to listen for, sometimes a specific plugin configuration string.
Modules usually include : installation instructions, sometimes a module configuration string, and how to use it.
Quote from: smashingredI am a noob to CMSs but I have reviewed Joomla, Mambo, and Elxis and this is the one for me. It does all the things I want it to do and more (I either need more money or skills.)
FYI, Elxis is a Mambo fork.
I certainly can understand the reason for choosing a all-in-one - one click install - prepackaged CMS. As I often say, it all depends of your sets of requirements for a project and how specific your needs are. For "standardized" websites, those CMS are probably the safest bet to build something quick and easy. I sure would have gone for Joomla instead of Mambo or a Mambo-fork, since Joomla has brought a lot of improvements over Mambo. One thing I am not sure I understand is how choosing Elxis fits a "niche strategy" as you seem to need for your projects. I would have thought you’d need a least some degree of customisation, something for which I wouldn’t necessarily recommend a prepackaged CMS... but that’s another debate entirely.
Quote from: smashingredWhat I would like to see myself is a more concerted effort to simplify the manager (the terms used, layout and behaviours) to make it less thinky. Usability should factor into the manager.
I am very much in agreement there. Usability most definitely is one area where CMS are lacking. Be sure we are working on this and have plans to make a significant leap with MODx 1.0. I don’t know if you checked the OpenUsability project and more particularly the
CMS User Interface Guidelines, but we did and we’ll definitely have and will give a lot of thoughts about this. I’d very much like to involve a usability expert at some point, and I happen to know one of the best guys around in France (Fred Cavazza, his blog is one of the top 10 french blogs and organizing the french
World Usability Day -> I’ll be there
in Paris on November 14th) which I’ll hopefully convince to give us a hand there.
Anyway, if you did test 0.9.2.1 and the latest 0.9.5 RC1 you’ll notice great changes already. These are incremental changes since we can’t at this point rebuild the manager from scratch, but I do think we already have a manager which compares well with competition
Quote from: smashingredI don’t know why we can’t come up with better names than Template Variables, Snippets, Chunks and Modules.
Naming conventions is one very much debated issue in a lot of web apps forums... I don’t think MODx is particularly more esoteric than other CMS. I mean, since you’ve chosen Elxis, like Jeffrey Veen
said, "The last system I evaluated had something called "mambots" which, to me, sounded like robotic assistance for breast feeding." A bit caustic humor, but I think Mambo and its forks are really not setting any example there...
I think Template Variables are quite descriptive of what currently lies within. Chunks are what they say they are, chunks. But no matter which term we discuss, when you learn a system you always go through learning the sytem’s lingo. But as Jeff Veen puts it "Please just use simple words to describe the things your system does." I think we did not do such a bad job there, but that’s just my opinon.
Now, it does not mean there is no room for improvement, just that again, I think we didn’t do that bad.
Quote from: smashingredI would also like to see some focus on the integration with other apps. While MODx is a very good framework, the future of the web is integration and synergies not reinventing the wheel. It doesn’t make sense to me to not have an easy way t integrate external apps into the frameworks. I would personally like to be able to integrate WordPress in a meaningful way, Zen Cart, osCommerce, OpenRealty (although I think I could beat this with a module or some sort of formatted entry system.) I would also like to be able to create data entry templates in the manager for the end user. Entry forms that extend or expand the capabilities of he Document Editor so that end users can add information that has a predetermined format.
I’ll let the devs go into details about that, but my understanding is integrating an application relies as much on the integrated application than it does on the integrating application. Meaning if session management, user management and the API is poorly written, integrating will be a real hell to achieve and (maybe more important) maintain.
About that OpenRealty bit, you can most definitely achieve something nice with MODx with a bunch of TVs, smart use of Ditto and/or Maxigallery I guess... or even writing a module like Susan did with ShopX.
Quote from: smashingredJust so you know this post may be influenced by Guinness but I still mean it.
And mine was influenced by a nice 1998 Saint-Estèphe (a red bordeaux), I confess, but I also mean what I said