I've been stopped on this thread for some time now, trying to figure out how to reply without seeming ungrateful, rude, annoying and spitefull. I can't guarantee that I managed to exract all of that out, but here's my best shot:
eyezberg wrote:This same problem: documentation! (or the lack of it) exists since I've first started using Mambo end of 2003. The same answers have always been provided. When I first began figuring my way arouund Mambo and its extensions, there were infos on various sites, and my questions about, then my demand for Help & Docs were answered the same way: don't ask for it, help us writing it! It's all voluntary etc.. So I did. I was on the Mambo doc team for a while with Jean Marie, getting most of the 452 docs ready. But felt we were not getting enough infos about all the constant code / feature changes, and there were new versions all the time, and we were always at least one version behind. So at the time of the Mambo => Joomla move, I quit.
A LOT of work has since then been accomplished in a short (internet) time, but a lot is still to do, as pointed out. So now *I* tell you: stop asking for docs, write them!
Well, here's the deal. I can't write documentation on something unless 1) I know it's there, 2) how it works and 3) how to use it. That's like telling some one who just bought a some assembly bookcase and having them write the directions for it. YEah, sure, we may know what we want it to look like, but if it weren't for that user manual, half the bookcases I've put together would come out looking like the one on the LeBlatt Beer commercial.... not what we want.
eyezberg wrote:Once you have used the soft for some time, you simply can not think like the newbie and get back to the most basics things, because you have already learnt and internalized that knowledge. So it is really up to newbies to document the problems they encounter, and the solutions to them, in a way another newbie can relate to and understand, and pass on that wisdom!
AH-HA! That's EXACTLY what us noobies are TRYING to do in the forums.... but then when help is asked for, we get shoved off.
eyezberg wrote: Coders should (and have started doing so; see the Devs part of the site) document the code and how to use it, that's a minimum to make extending the Core as easy as possible.
I *don't* want to extend the core.... I just want my stupid website up..... Some of the documentation is OK... and adequate for geting things rolling... IE, the loadmod function... plain and simple it displays modules that are marked for that "section". Great.... now, what I really need to know is how to create a module that will do XYZ. Next step searching the forums and spellunking through the plethora of results that come back.... It's disheartning. I tried searchign for a way to change the layout of the frontpage. What I found was an obscure reference.... on the second page I might add .... that if I clicked the "Home" link from the "mainmenu" in the Menu section of the admin, I could customize the frontpage some. Woah! Hold the phone... WTF was THAT in the documentation? Nowhere.... But that attitude from some of the posters was like it was obvious to them, it should have been obvious to the rest of us.
eyezberg wrote:3rd party extension devs should indeed, I fully agree, document what they contribute. Emphasis on *should*, who is to telll them: hey, you gave me this great extension for free, now tell me how to use, where's the mannual? Coders are coders, anyone here can help document any part of J! or an extension they use.
I'm not going to get into 3rd party items.....but I will say this, if I'd never supplied any documentation to any of the add-ons I've built for other systems, I'd been strung up by my toenails.
eyezberg wrote:Look for a faq, and submit a tutorial to explain the solution. I started writing some again in my own corner of the Net.. more to come. Now, up to you to contribute.
HOW? How do you expect me, the lowly user to contribute to something I know nothing about? All I can do is post to the forums, learn from there and hope that someone is watching and will gather the info into the documentation. That's how we've been doing it on another OS proj I'm a part of. We watch the forums, see where people are getting trapped, then write documentation on how to 1) not get in that situation in the first place and 2) if you get into it, how to get out.
eyezberg wrote:As you say yourself "the problem in a nutshell: Writing step-by-step tutorials are very different from writing in general. Mainly, it's a lot less fun. It involves the kind of thinking most people would rather not do -- dumb thinking". So you demand people to think dumb and do things which are not fun to help you out..?
Actualy to do that kind of thinking requires some smart thinking. One has to think out of the box, I've got a QA dept that proves this point time and time again to me.
eyezberg wrote: Why should they? Because they provide Joomla they also have to tell you how to use? They told you the issues are aknowledged, being worked on (be volunteers), and a manual is in the works, yet all you have to say is "docs are bad", over and over.. "The newbie with no background with cms's will not be up and running in a week." is false, I was, and I'm not a boy wonder ot whatever it was you called that, I was just interest enough to try things out, search the forums and various sites for information, and at that time, there were almost NO docs at all!
All hail boy wonder then.... I'm two weeks into this and NO closer to getting the site I want. Sadly the more I try to go through the forums to try and find the answers I need, the more discouraged I become and the more I question my decision to go with J!
eyezberg wrote:At the time of Mambo 452 docs (which Joomla 1.0 was based on), it was decided the docs should describe the interface and it's functionality, and tutorials written by community members should cover the rest.
And that *should be fine....But as in the example above... even descriptions of the interface and how to simply get around in the admin area still has a ways to go....
eyezberg wrote: There's always only so much you can do in the time you have to offer, but if everyone here picked up just one part / screen / step and documented that, everything would be done already.. nearing 30000 members.. but noone has to. But those who complain should.
Maybe I *should* dump J! Granted, I don't think anyone is expecting a color-glossie-paperback user manual.... But a Quick Start guide would be nice. Ok, the install directions were great. Easy to follow, got things running on my laptop in minutes. Cool. But now what? I'm left on my own. How do I get content into the site? How do I manage what goes on the front page (found that out by accident just clicking buttons)? How do I install a module, a component, or a bot? And content access... OK, I get "Public" I get "Registered"... "Special" - what does that mean, how do I control it? What if I want something listed to the public, but NOT registered member? IE, a welcome message to the site extolling the advantages of registering. Once the user is registered, I don't want them to see the message?
eyezberg wrote:You complain about docs, to conclude Joomla is not user friendly. This is unrelated. A piece of software can be so easy to use you don't even need any instructions. If Joomla, or parts of it, fail in being that easy to use, then please
* point out which part(s)
* why, in your opinion
* how it could be better
To sum up: help us to help you

Here's a quickie - when the user clicks "submit news" and gets the editor. trying to navigate to anywhere else results in a nasty "Please click cancel first!" error. Why? Why can't the user just click away from that page?
Tonie wrote:[quote=∓quot;ricland"\]
Complaining is good. Going out for the college basketball team when you're 5'6" isn't. You're wasting your time and everybody else's.
Complaining about an open source program like Joomla isn't good, it's just plain rude and an offense to everybody who are giving their free time to the project.
[/quote]
Then be prepared, I plan to be scathing... if you can't take the heat, then this is not going to be the place to be.... anybody involved in anykind of project like this has to be able to handle criticism... good or bad.
Tonie wrote:[quote=∓quot;ricland"\]
Don't listen to the geeks who tell you there's nothing wrong with Joomla. Joomla is not for geeks. It's for dummies like me!
Thanks again for calling everybody here 'geeks'. Why is Joomla for people like you? Joomla is build by the community in combination with the developer team, Joomla is theirs. They made it what it is today and decide which way it is going to go. There is a lot of effort being done to make it better than it is today. We all know Joomla isn't perfect, but what is? I'm just happy that Joomla exists, and it does all these things for me. IMHO if a person can't have a running site within a week, they need support from a person who has done it more often.
[/quote]
What? Is J! only for geeks then? Only a geek should be able to use it? That hardly seems fair. I AM a geek (hear me type) and I find J! to be one of the most difficult products I have ever worked with (not the worst... that honor goes to the SMARTY template system). I AM that person who CAN'T get their site up in a week.... I NEED HELP... and that's why I started looking in to the documentation and the forums. And I still can't get what I want out of this thing.
Tonie wrote:[quote=∓quot;ricland"\]
Again, making Joomla "new and improved" is not what's needed. Drop everything you're doing. Throw away all your whiz-bang plans. Don't make Joomla better, make it easier.
I don't think people posting in the wishlist wishing for multisites, multilingual sites, SEO friendly, database support would agree with this particular statement

. The CMS world is in its infancy, there are too many quick gaines before a CMS will become just another default technology.
[/quote]
All the bells and whistles in the world aren't going to amount to a hill of beans unless the AVERAGE user can't figure out how to make it work. As it is, I can't even figure out how to put more than three things on the front page (in a lyaout of my choosing).
Tonie wrote:[quote=∓quot;ricland"\]
This Joomla is not user friendly. Swallow your pride and admit this. I know it hurts like hell to admit this, but as they say in AAA, the first step to recovery is to admit you're a drunk.
Joomla is very user friendly. A user of Joomla is an editor who creates content for his site visitors, this is very easy. A person who builds a site is designing, a very distinct difference.
[/quote]
*scratches head* Umm.... but.... one uses J! to do part of the DESIGN!.... I've NEvER had this much trouble getting a site up and going. Disclaimer: here's a little bit about my self. I am a developer. I design and develop software for a living. It's what I do. I also do some web development. I've done a couple fo Xoops sites, static sites, an ecommerce site, my company's web page, and a half-dozen personal sites (last of which was done using WordPress). So it might be that I have a slight edge than Joe Smith out there.... so it infuriates me that I can't figure this out. That tells me that it's not as intuitive as it should be. In some parts of the admin, I have to click cancel to get out of a screen... other cases I can jsut browse away from that section. I am the designer and I am the editor... and I cant' make heads or tails out of most of what I am encountering. The design of a site using J! is very much integrated into the guts of J! I know that once it's set up and I get all the modules I want configured - basicaly once it's designed - then the editing and the content entry will be a snap. So in that sense, yes, for the edit, after all the hard work is done, it's easy.... but I have to GET THERE FIRST.
As I go through this more and more, I'm really begining to wonder if J! is even for me, of if I should resume my search and look for something else.
Oh, and I'm not even going to dinify the FrontPage remark by replying to that. I won't stoop to FP's level.
-tg