I'm relaitvely new to the drupal community. I've found in short time that drupal to be a great tool in developing websites. I'm finding it hard to get support for it though. I don't know know if my expectations are too high, if my assumption of Drupal's purpose in the market is skewed, if drupal support just isn't there yet, or if i'm not looking in the right places.
I'm finding that although the drupal core and contribuated modules have relatively complete documentation, there are not many tutorials that tie it all the together. For example, you can find multiple posts scattered across the post-installation forum that I've made in trying to get I think basic "how do I do" types of questions on menus and taxonomy - basic, common issues i'm sure. I appreciate all the feedback that I've gotten. Unfortuately, most answers have been complementary at best. When the forums don't give me answers, i can't find any tutorials to tie everything together, where do I turn for help? As an open source project, there is no toll free support line. Some have suggested that i "roll my own" and code my own solutions.
I'm assuming Drupal is positioning itself in the development market as a robust tool that both professional and amatuer website developers can use. I'm assuming that is wants to compete with the development leaders (DotNetNuke, etc. etc.) Many people can write and contribuate to the Drupal solution. While many of us cannot and do not want to. We are the customers. It's an insult to tell a customer to just go "write your own solution". I also hope that I do not find that the documentation is intentionally skimpy to ensure that people need to hire consultants that are well versed in Drupal. I hope that the help really does exist and i'm just looking in the wrong places. Because only robust support options will allow Drupal to compete.
So, at this point I do not see how any one is actually using Drupal in developing websites. Where do I get the timely help that I need to make a website in Drupal? Maybe I'm not looking at the right parts of drupal.org or are there any websites that have drupal tutorials that everyone knows about that i'm missing? Or any other support options that I'm missing?
Is this partially a rant? Yes. Is the title a little sensationalistic to get people to read and give feedback? Yes. But more than that, I think this hits on real issues that hopefully spur some constructive conversation. Because at the end of the day I think Drupal is a fantastic product with a fantastic future.
- Jason-
Comments
Here's a good answer to your questions:
http://www.robcottingham.ca/20060327/coming-soon-two-drupal-book-reviews/
I want to be a farmer.
these books look promising
thanks for the link lectric. they look promising.
Two things
1) Don't use caps. It is considered shouting, rude and obnoxious.
2) You can always pay a consultant to help you out. There are plenty to be found.
--
If you have a problem, please search before posting a question.
give me your insight
Thanks for the tips Steve (i understand how caps are considered - it was my intended effect). I see that you've been a member of the site for over 5 years and are a core developer. Can you shed a little more insight into the support issues I brought up? Are you saying the bottom line is that the only/major support option is to pay consultants?
maybe try to experiment?
I posted a reply to your htmlArea post
http://drupal.org/node/56439
You've hit the problem right on the head, and even posted the answer along with it. You're on the right track, don't let negative emotions get a hold of you, and you'll find that drupal is easy as following your instincts.
Sometimes, many ppl here on the forums don't know the answer to your questions. All we can do is help you along.
another viewpoint
I'm also a drupal newcomer, trying to convert an existing website onto drupal.
I've had a radically different experience from the original poster; questions are answered within minutes! with insightful answers, and even though the taxonomy system was initially difficult to understand, there are tons of pages of documentation illustrating how taxonomies can be different from or similar to simple categories used in other CMS's.
I'd like to congratulate the drupal community for one more convert (ME!), and I realise that there are so many of these "help me now" posts that the locals have become a bit jaded (ie don't bother answering ...). That's a concern to me, but it hasn't affected me yet.
To the original poster, the competitiveness of Drupal is not necessarily the same as handholding customers (even just a bit). Sometimes it can get rough as your questions get brushed off, but think of it this way: all opensouce projects have limits in resources. Some projects spend much time helping newbies, writing tutorials, etc, but the drupal community is less inclined to do so, not because they don't want to, but maybe because they don't know how to (ie. you need talent to write good, understandable documentation!) or they don't have enough time.
Drupal is extremely competitive in the CMS market. It just chooses to allocate its resources to the things it's good at: writing kickass code for highly scalable and flexible content management.
Not to be overly simplistic...
but have you looked at http://www.drupal.org/handbooks
It covers more than what is needed to set up any simple site and gives pointers towards advanced usage.
If you are looking for something more than just a simple site, you ve two options: A) learn to do it yourself (thats what I did) via the documentation that exists and the 'open' source code that is available, or B) Hire a developer.
I'm definitely not trying to turn anyone away here. I haven't seen your questions in the forums, and there are no links to them here. I do know for a fact that the drupal community is a VERY helpful bunch and give whatever aid they can.
If you truly think there is some grandiose plot to drive drupal consultants demand up via skimping on the documentation, then you are mistaken..
Anyone can contribute. Period. There is no can't, at the very least you could go onto the forums and help people who are just beginning cross the same hurdles you are dealing with. You could confirm reported bugs, just by installing modules. You could *gasp* write documentation for the things you do understand. Or you could hre a developer and return the result back to drupal - sponsored by you. But if you think that we are here to serve in any customer service related manner - you are mistaken. Hire me - then you can be the customer. Otherwise, roll up your sleeves and help yourself, or ask a specific question. The code is open.
I've looked at the handbooks
They're good stuff. The individual topics are documented very well. I've had difficulty finding tutorials that tie all of the topics together.
explain more?
Maybe you could tell us what "tie all the topics together" means? What do you want to see in addition to what's in the handbooks right now?
If you could articulate what would help you, then it's easier for the community to prepare these documentation to help others in your situation.
Thanks
(ps i hope i'm not offending anyone, I just want to help with identifying what the problems are...)
Yes, being specific is very helpful.
I have to agree. What do you mean by 'tying it all together'?
here's a little more explanation...
The biggest piece missing to "tie it all together" are tutorials written from an operational instead of a technical aspect. It's great that each module is well documented - that's needed to learn the technical nitty-gritty setup of each module. But in the real world - it usual operationally takes multiple modules to create a robust solution and website. It would be helpful to either see tutorials that say "here's how to create a blog site in drupal" or "here's how to create an inventory site in drupal" or whatever. Of course it may not fit everyone's needs perfectly, but it would shed light on the big, sometimes cumbersome, complex, cranky tool called Drupal. It would discuss all the different modules that are needed, all the little gotchas, etc. that you actually encounter in the real world.
Look... i should say my background. I'm a hardcore IT geek... i pride myself on learning on my own, diving in, and learning, living, loving IT. I understand communities like Drupal - the nature of open source, communities supporting and helping each each, etc. But I've also learned that sometimes you need to look at how to tackle something operationally instead of technically. I've learned this personally. This is why the IT Dept of a company is usually seen disconnectd because they think technically instead of operationally - how the business will use the technology to acheive operational goals. Showing how to tackle website development from an operational standpoint - I think the drupal community does not do this very well. I think this is how'd i'm summarize my issue with drupal support in one sentence.
for those that have suggested it, I love to write and explain things. I would be willing to contribute to writing drupal documentation. And please keep the comments coming - I truly want to better understand the thoughts and flows behind this community and then see how I can help.
- Jason
I think I see the disconnect.
I see in your writing the idea that it should somehow be incumbent upon Drupal and the Drupal community to in some way 'sell' itself better. And coming from the standpoint that you just explained, I can understand why some many people in this forum topic are railing and getting upset.
While I can't talk for anyone else except myself. The drupal community is a large group of developers working to make each others lives easier by sharing work they have already done so others can build upon it. The only 'sell' we need to make is to other 'technically minded' developers. So in that respect, while 'operational' documentation is nice it is also the lowest priority.
If we were an IT department, that type of documentation would be highly valuable, essential even. But at the moment this community seems to be about creating a highly robust tool for saving all of us time in web development.
Another reason I think you are hitting a lot if irritation is the comments originally about not wanting to contribute:
In the post directly above you mention being willing to contribute. In your original post it sounded a whole lot like you were insulted that the community didn't make your site spring fully formed from the head of Zues, AND you didn't want to give back drupal.
That was taken by a lot of people as an insult.
I hope you follow through and help with the documentation. Cheers!
i'm seeing that...
this community is much more "techie-to-techie" discussion that I first thought. and that's ok! :) it's not good or bad - it is what it is. but i think that is the disconnect when it comes to not having things be described from an operational standpoint. At a least we're now understanding each other a little :)
About my comments about not wanting to help: I definitely just want this stuff to work - it's frustrating when it doesn't ya know! :) But I understand the blood, sweat and tears that you guys are pouring into drupal and it really shows. I don't want to code, but I'm definitely fine with helping with documentation...
Check out site recipes
http://drupal.org/handbook/site-recipes
The recipes started a little while back, and have the potential to be a powerful learning tool.
RE:
This process is exactly how things change -- people spot a need, and contribute to meet that need. The Drupal community is a great place, and you will get back exactly what you put in. When people make demands, they tend to get frustrated. When people observe, and back up their observations with contributions (of code, documentation, etc), they tend to gain from the experience.
Also, consider joining the documentation list: http://drupal.org/mailing-lists
Cheers,
Bill
-------
http://www.funnymonkey.com
Tools for Teachers
-------
http://www.funnymonkey.com
Some things I have noticed...
I think, for the most part, the support for drupal is great. I have had simple questions answered within an hour or so on the forums. This is great, and helped me get something workable up and running right away. I am extremely new to website development and chose drupal from the customizability I saw. I have, however, had difficulty finding solutions to questions that tend to run off the beaten path. Some modules provided, for example, provide close to the functionality I am looking for, but not all. Some posts I make go unanswered. Is this bad? I dont think so, since its not the core of drupal, people might not be as familiar with it or inclined to take the time to even search these posts out.
All in alll, I love drupal and plan on creating more content with it. Who knows, maybe someday I will be able to answer questions in a knowledgeable manner as well. :)
Mike of Sighing Sage
Let's make one thing clear
Let's make one thing clear: you are not a customer. If your question goes unanswered or isn't anwered to your satisfaction; too bad. There are multiple reasons why some questions go unanswered but it's all we can do with free, voluntary support.
--
Tips for posting to the forums.
When your problem is solved, please post a follow-up to the thread you started.
I think your assumptions are
I think your assumptions are wrong. You make assumptions about Drupal as if it were made by a company. A company that seeks to generate revenue and to outcompete any similar companies.
This is not the case. Drupal developers do develop Drupal for their own personal gain, but there is no steering comittee of any kind. So basically you can use our code, bu if you don't get the support you need, it isn't our problem.
--
Drupal services
My Drupal services
--
Drupal services
My Drupal services
drupal needs contributors and collaborators, not customers
This is probably not the place for "We are the customers." There may be some community projects that are positioned along your views on customer support, but my understanding of the Drupal community philosophy is a little different. While certainly people do often contribute support in the forums, develop documentation, fix bugs that are problem for others, the orientation here is more toward building a community of contributors and collaborators that work together to create a product, not supporting customers looking for free support and documentation. I used this analogy before, but I think it's worth saying again. To borrow from John F. Kennedy, the prevailing philosophy is "Ask not what Drupal can do for you; ask what you can do for Drupal." This is not a bad project management philosophy because it leaves people a lot of freedom to do what they want because there is minimal bureaucratic overhead and encourages participation, but it does not offer the solution you are looking for. Instead, Drupal is about working together first and foremost, not about providing free services.
Now this doesn't mean that there haven't been discussions and interest about creating documentation of the type you describe. Certainly, people have been (and will continue to be) encouraged to do so. But if it's done, it won't be because of an orientation toward satisfying customer demands.
We are the free Web CMS Customer Support, so are you!
I agree with cel4145 about customer support. Besides Drupal being more flexible and open compared to things like Microsoft CMS and the CMSes being pushed by corporations, we choose Drupal/Opensource because we do not want to pay lots of money for a product that we may not like and that we cannot directly influence mid-way.
I started using Drupal a little over a year ago and I read posts, played with it (I did not kow PHP at the time), broke it a few times and got help from the very responsive community here. In time I also started answering peoples questions and even guiding them in detail whenever I had time. That is my way of giving back to Drupal. Not to be tough on you, but a tool as good as Drupal is many thousands of Dollars per seat and they willnot give you source code. So we all owe it to this gift to participate in the community and if anyone needs more help that one can get from the community, manuals and books, I think it's fair to pay a consultant or a knowledgeable participant for more dedicated time in finishing a project. That will cost a fraction of what you will pay IBM or Vignette for a single support call about their Web CMS.
If you need help, we are ready to help - Just my 2 cts
If you need dedicated customer support, contact me and I will charge you a fair price
-----
iDonny - http://www.cmsproducer.com/web-cms-development-design-emarketing
problem with the "zero cost" model
you made me realize that part of the problem stems from the people that are thinking of open source as zero cost. Those of us that are happy to use Drupal realize that there is a cost in terms of learning the software, and we believe that Drupal gets better from the time that people invest in development, documentation writing, or support. Time is an economic form of payment because it's an opportunity cost even though there is no financial payment. And since it is mostly volunteered (or, developers have managed to find clients who "sponsor" their work), we appreciate what is offered (paid for in terms of time) rather than expecting or demanding what we think we deserve for free.
www.drupalecommerce.com is for beginners and intermediate users
www.drupalecommerce.com is for beginners and intermediate users
Our most popular section is the one on example sites and recipes. We are building this up.
-----
Drupal ecommerce
see http://www.drupalecommerce.com/47vs46 to read
"What are the main differences between 4.7 and 4.6?"
I'm also relatively new to
I'm also relatively new to drupal... waiting release of 4.7 and CCK to start working with it.
I think you CAN'T expect support from a free open source project like this, like you would expect from a company. No one has any obligation to answer your questions, so sometimes you will get great answer from the community, sometime you will never get your post anwered. It is like a lottery.
This is how it works with open source free project. It is up to you to decide if you want to use a software built in such a way.
Personally, I think Drupal is worth the try, but i'm not 100% convinced (yet).
Cordially,
Brakkar
Yes you are the customer
And I have great news: if you are not satisfied with Drupal, you are entitled to a full refund. If you yell even more, you can get back twice what they paid for it! You are on the good road.
--
My developer blog. | The news is Now Public | Ask not what Drupal can do for you -- ask what you can do for Drupal.
--
Drupal development: making the world better, one patch at a time. | A bedroom without a teddy is like a face without a smile.
sarcasm is great...
paraphrased from 40-year old virgin I speak sarcasm like a second language... i'm riiiggghtt there with ya
"Customer" expectations
This is a common problem with people who don't understand how open source works. "Customers" don't participate in these discussions, peers do. And, as with any peer group, reciprocity is the basis for the exchange.
What do I mean? Well, in any vendor-customer relationship, the basis of the exchange is the amount of cash/goods that changes hands. In the open-source world, the currency is ideas, not cash. So, if you want to get, you gotta give.
If you don't like the end-user or beginner documentation, jump right in and help rewrite the documentation so that it addresses questions like the one's you are having. But first, learn about the people you are working/interacting with. This is a rich community of cluebies, newbies, duffers, novices, and experts, many of whom don't speak English very well.
This is a self-organizing community and there's lots of room for good ideas and suggestions. But there is little room for demands. Everyone's here because they chose to be here, not because they were promised a level of service, quality or specific kind of code. Drupal exists in a rich environment of competing CMS paradigms. Many of us who have worked with proprietary and commercial systems understand what has been built here and gladly trade off a level of uncertainty and confusion for what we get in return. If you aren't willing to make that trade-off, Drupal, and for that matter, most other open-source CMS frameworks probably aren't the right fit for the challenge you are trying to address.
With that said, there ARE developers here who are willing to provide handholding for a fee. Hire one if you really like the idea of Drupal, don't have the time to read what you need to read in order to figure it out, and really want to jumpstart your use of it.
Good luck!
You better expect nothing...
Dear customer,
For your information: Drupal is Open Source. Which means, it's free. Therefore, you pay nothing. Now, if you pay nothing, you better expect nothing. Because then, all you will ever get becomes suddenly much more than you expected! Isn't that great?
You want to know my opinion? Drupal offers a lot. A whole lot, for nothing.
No shop in the world can conform to that...
___________________
discover new oceans
lose sight of the shore
go to www.drupalecommerce.com
At www.drupalecommerce.com, we've decided to write documentation for the beginner and intermediate Drupal users. This will help take Drupal to the next level.
Drupal documentation is written for programmers or people who can read code, by and large. Here is a great example. Merlinofchaos, who has written the highly acclaimed new views module, has written documentation for it, which is here:
http://drupal.org/node/54432
However, if we were to use the terminology of recipes, this is only the list of ingredients.
beef stir-fry.
1 green onion
2 pieces of beef
3 red peppers
some soy sauce
Okay. That's fine if you know what to do next because you've made chicken stir-fries. But if you don't know anything about stir-fries, you are not going to know what to do next.
what the documentation does not do is say
1) cut the onion and beef into half inch pieces
2) put 2 tablespoons of oil in the pan
3) turn the heat up to high
etc, etc.
Now it makes sense the the documentation is written this way because
A) programmers are very busy writing code and don't have time to write documentation
B) programmers think like programmers, not like end users who know nothing about Drupal or programming.
We think it's great that merlin took the time to write so much documentation for views, which is much more documentation than there is usually.
Now what we are starting to do at www.drupalecommerce.com is to provide the list of steps.
For example, here we've begun writing a tutorial for the views module:
http://www.drupalecommerce.com/node/323
we hope to eventually to do this for all the important and non-obvious modules.
That section is not finished, so you may get more out of this page:
What are the main differences between 4.7 and 4.6?
http://www.drupalecommerce.com/47vs46
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site designed to answer the questions of Drupal beginners and intermediate users. It is in a very early stage, but it does have about 300 pages. Quick links to "Modules," and "Example Sites."
Why not in the handbook?
The obvious question: why not add such documentation to the handbook?
--
Tips for posting to the forums.
When your problem is solved, please post a follow-up to the thread you started.
this is why
Heine,
Thank you for asking. The reason is here,
http://drupal.org/node/44233 and in many other places.
We've seen the same suggestions made over and over.
For example, that each module should have its own section in the handbook where people can ask questions and find answers.
For example, that there should be a quick link button on the front page for newcomers.
For example, there should be a list of "Frequently Asked Questions" that should be very easy to find.
After seeing months of people trying to argue for changes in drupal.org, we decided just to go off and do it.
We'd like to say that we have high respect for Sepeck and the Documentation team. That Sepeck is doing all this while purely in his spare time suggests that he is phenomenal at multi-tasking and time management. He should write a book on it.
Heine, we see you in the forums a lot answering questions and we appreciate what you do. Hopefully, this will reduce the load of the same questions that are asked 100 times so that you and others can answer other questions.
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site designed to answer the questions of Drupal beginners and intermediate users. It is in a very early stage, but it does have about 300 pages. Quick links to "Modules," and "Example Sites."
arguing is not doing
People argue all the time for changes in Durpal; very few actually work to effect change on drupal.org. That tends to be the problem.
Really, it's too bad, though, that you you weren't willing to assist with developing the handbook on drupal.org. So much duplicate effort here.
I tend to agree....
In all this arguing did anyone offer to create a FAQ for drupal.org, or just ask that one be put there? In all honesty I think it is great that people are writing these tutorials, but this makes, I think, the 5th post in the forums I've seen touting the greatness of this new website - a few of them really only tangentially related to the topic at hand, but making sure to get the link and a brief shout out about what is going on at drupal ecommerce. com ... ... ...
While I can appreciate the enthusiasm, I have to question the methodology, both in breaking out from the existing documentation, and in the advertising methods that I seem to see.
Really, it's too bad,
Not necessarily. I have seen drupalecommerce.com and I doubt if the intention is to deliberately maintain an information silo distinct from the drupal.org handbooks. If that documentation is good, I am sure we can find a way to put most/all of that stuff back in the handbooks- just a request should do, if I am not mistaken. I think, instead, we should compliment the effort being put into that site.
I don't know if I am alone, but I often get the feeling that it is easier to sift through the forums for solutions and put together my own documentation than contributing handbook pages. I have personally decided to grit my teeth and submit to the handbooks, but another person may think differently. In some respects, this kind of distributed production of documentation is good because we can look at the resources generated in this manner and then pick and choose the best stuff to feature in the drupal.org handbooks.
Complete utter mis-statement
No. The suggestion is for 'individual forums per module' that I am against (I also said you have to convince Dries too) and I have clearly stated my reasons for this in the discussion about adding forums. So far only one person has provided an alternative and I provided feedback and suggestions for that person to help them. The handbook is not for forums or support requests.
There are contributed pages for modules in the handbook for core:
http://drupal.org/handbook/modules
and for contributed modules that people have written up:
http://drupal.org/handbook/config/contribmodules
and donated to the handbook. People can provide sub pages to add on and claify such modules as can be found here and here.
Many people have stated before that subpages to these module pages would be VERY WELCOME! And I or others approve new pages fairly quickly.
I have stated that if anyone EVER actually contributed these mythical 'newbie' docs/tutorials I would be MORE then happy to add a handbook section. So far despite my begging and pleading and being attacked and mis-stated many times, not one of the people who have lambasted the handbook for lacking this information has EVER supplied such documentation.
I, in desperation, in my spare time even started writing some intial stuff on my site to be moved to the handbook when completed because as far as I can tell no one else is going to contribute any. http://www.blkmtn.org/book/drupal
I have had some success with a few people adding to the site-recipe section: http://drupal.org/handbook/site-recipes
You want to write up a FAQ? Then fine, please do so. This is something I KNOW I have repeated to you. If it exists then links can be changed over time. But not until it exists. I have NEVER said I was against FAQ pages EVER!
I will notee that cel and heine are major handbook contributors. I just happen to be a more visible face to it.
I so thought I was going to be able to avoid this thread too. :(
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide
oh yes
wow - i've seen the future of Drupal documentation - and it is www.drupalcommerce.com :) this is exactly what is needed to "tie it all together" as I say. I LOVE your analogy about the ingredients to a recipe vs the steps necessary to make the dish. Wonderful!!!!! You know how you get that nice gut feeling when you get excited when reading and learning about something - that's just the feeling i got when reading the tutorial on views mode. I'm like "OHHH - that's how this all works!!! - this is neat!" :)
Beautiful!
- Jason
thank you!
Jason,
Thank you! Would you believe you are just about the first person who has said "thank you"? We really appreciate your post.
Drupal ecommerce
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site designed to answer the questions of Drupal beginners and intermediate users. It is in a very early stage, but it does have about 300 pages. Quick links to "Modules," and "Example Sites."
you're welcome...
keep up the good work. it helps if i include the correct link when i'm praising a site though huh - it's www.drupalecommerce.com for the record ;)
No Reason to Fork Drupal Documentation Here
I already posted in this thread, but after further thinking, I want respond directly to this. Now that sepeck has taken over as Documentation Coordinator, I feel I like I can be blunt. There has *never* been in a disinterest among those working on documentation on drupal.org in having new user and intermediate documentation. Just need people to write more of it, and there has been *lots* of effort to rewrite documentation so that it would be more usable for newbies and regular, non-developer users.
Now, I can understand why ae5005 wanted to setup a review site for modules on drupalecommerce since this was not available on drupal.org. But a review module is not the same as the documentation being described here. I do not understand why there is a need to fork Drupal documentation efforts in this circumstance. There is no reason that more newbie-friendly module instructions and site recipes cannot be created in the Drupal handbook other than the fact that someone has to just do it. At this point, the only reasons I can imagine for drupalecommerce to start such a documentation project are
1) Those working with drupalecommerce are unwilling to work with the Drupal docs team to revise and create new docs.
2) Those running drupalecommerce are trying to create a lot of traffic for themselves for personal reasons.
I'm guessing it may be (1)? Was there some problem working with the docs team to improve documentation?
time discussing
hi everyone,
Cel, thank you for all the time you put into leading the documentation effort before sepeck. Leading documentation for open source software seems like one of the really import and most under-appreciated jobs we can imagine.
We've seen enough long discussions on drupal.org to not want to get bogged down in it. It seems like someone could spend a lot of time trying to persuade the Drupal team to do something, and have it possibly never happen. Or just go and do it.
For example, you go to Drupal.org. What's the most prominent link on the right?
It's download the latest release. Now someone is fairly knowledgeable if they know how to download and install Drupal. They are not the beginner who has never seen a line of php code. This is the entire feel of drupal.org. We don't see it changing. We think maybe that's what is right for Drupal.org
To write documentation on drupal.org means to get things approved and persuade sepeck and heine and cel and amazon, etc, etc. It means a lot of time invested in persuading people that could see nothing ever result. For example, we could try to persuade Dries to put a "New to Drupal" button at the top of drupal.org. If he decides not to, all the time spent putting into persuading is gone. Whereas if we take the time and write down documentation, then there is something finished.
We also find that we like being able to edit posts over and over again, to have the flexibility to do what makes sense to use, without getting approval from someone.
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site designed to answer the questions of Drupal beginners and intermediate users. It is in a very early stage, but it does have about 300 pages. Quick links to "Modules," and "Example Sites."
Here's the process for you.
There is a handbook tab on the top. I am not interested in discussing the layout of the front page as that is a seperate and more involved topic and not under my control.
I am willing to discuss the handbook. So I will describe the process I use to approve handbook pages. It's really very similier to the process used by the others. I click a link on the right I see called Handbook updates. I look at that list. Anything in the 'Approved no' column I go and read. If it looks good, I check that's it's in the right section and approve it. On occassion, I send a note asking the originating author to clarify, expand or mention someting that could be included.
So far in three months I have only not approved spam and rolled two other pages content into existing pages that the contributor missed. Occassionally I correct some typo's (and others correct mine).
If you contributed a page and edit it, it gets knocked back into moderation. This merely gets the process repeated.
I am not the only one approving pages there are several of us. So pages in moderation rarely stay there more then a few hours or a day.
As a bonus you get your nick listed here for all to see who contributes documentation.
Please do not attempt to say there are barriers in place that flat out do not exist. If you create content, it gets used. If the section doesn't exist and I come across a tutorial page, then I or someone else will make one for it. So far no one has ever actually produced a tutorial for new comers. There is one in the developers handbook for modules.
No where in this process is persuading me or anyone. There is merely is this applicable to Drupal? If it's related to Drupal, then it's applicable.
Please feel free to contribute content. I am certainly not in your way.
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide
300 pages
Sepeck,
thank you for laying it out. Is it incorrect then that a few months ago there were 200 pages or so waiting to be approved that were invisible to the public?
We've added 300 pages in about 2 weeks. A page may be revised as often as 20 times a day. We find we really like the ability to go in and tweak a word to make something really clear.
Also we've organized the 300 pages in ways that make sense to us.
We believe Drupal is the best CMS out there, and that's to be credited to the team behind it.
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site designed to answer the questions of Drupal beginners and intermediate users. It is in a very early stage, but it does have about 300 pages. Quick links to "Modules," and "Example Sites."
The information I have laid
The information I have laid out is not secret. I have said this in any number of posts across any number of forum discussions and find it appaling that anyone would claim otherwise.
Not knowing where you are citing this information I suspect it is in fact not accurate. There were a number of unpublished projects. There were also a number of unpublished pages that went to content for those projects that is no longer relavant, accurate, available, combined, etc that had not been gone through for a while. Oddly enough Drupal being 5 years old had developed some old information. Most sincee have been pruned. There are more people monitoring this now. It's a team effort, not the work of oen or two.
300 pages? It's not about page count it's about content. I believe someone blogged that the Drupal handbook printed out was 1000 pages.
So, I will point something out about the organization of the handbook now.
In your local Drupal (4.7) site, if you have the help module turned on you have admin >> help right? Click on it.
That takes you to this page ?q=admin/help
Let's pick a common one, taxonomy ?q=admin/help/taxonomy
At the bottom of this text is a paragraph with a link
For more information please read the configuration and customization handbook Taxonomy page.
If you click on the link, you are brought back to Drupal.org. If anyone has provided additional information to that module since release, they will now get the updated text and and additional material people have seen fit to contribute as child pages.
It was publically discussed that after additional features/permissions had been added to the 4.7 handbook that opening up editing would be tested and tiraled. This was several months ago but the extended testing cycle fo 4.7 due to lack of people contributing to test/qa has delayed this. As we get closer to 4.7.0 actual release it gets more posible.
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide
misinformation
With a site the size and popularity of drupal.org, moderation is a necessity or we'd have as many spam handbook pages as not. And, if my calculations are correct, there are between 1100-1200 handbook pages currently available. There has to be some kind of management process for a text that large.
Nevertheless, as sepeck has pointed out, there is no great amount of time to "presuade" anyone to approve posts in the handbooks. When I moderate, I generally just look at them to make sure that they are not spam, are located in a good place in the handbook, are not duplicates that I am aware of, and are not poorly written and formatted. Besides, if you were willing to edit "posts over and over again" then you would end up being a moderator before too long. Pretty much everyone who has demonstrated a willingness to work on the documentation regulary has had their privileges updated so that they can contribute more easily.
As for adding links to "new to drupal" stuff, well the documentation team is the one to argue that. The documentation team has made a lot of strides in improving Drupal and drupal.org usability. Of course, you'd have to participate in documentation development here to learn these things (one who has participated would know what sepeck has described). So whatever your reasons are for for not wanting to work with the doc team, don't encourage people to abandon documentation efforts here by providing misinformation.
By the way, what is this "we" thing? Sounds like one (anonymous) person has been writing these posts for drupalec. Who is this?
unfinished pages
Another difference: drupalecommerce.com has unfinished pages. For example, activeselect sounded like a very exciting new module, so we made a page for it.
http://www.drupalecommerce.com/node/332
There are simply no pages like that in the handbook. And we don't imagine there being any. It may very well be that there shouldn't be any pages like that in the handbook, which may want to have a more finished feel. We wanted to have a site where we can have the information in a way that's easy to find.
What we thought needed to be done to make documentation accessible to newcomers cannot be fixed by simply submitting a pages. We would completely reorganize the handbook. It's very difficult for a newcomer to find information in the handbook because it's not organized the way a newcomer thinks.
Here's an example. A newcomer wants to change the footer. Where do you look?
No idea.
okay. search on Drupal. search on Google. both give you this.
http://drupal.org/node/8042
what section is this in?
customization and theming
theme developer's guide
xtemplate theme engine.
you are a newcomer. you have no idea what a theme is. never heard of a xtemplate. is a developer a programmer or is it different?
There was a great quote by someone saying by the time you figure out how the handbook works, you have forgotten why it was so confusing when you started. Now getting the documentation team to completely reorganize the handbook is not going to happen, or if it ever does, would be after a tremendous amount of persuading.
We apologize if it seems we have provided any misinformation. That was not the intention. We officially encourage everyone to contribute to drupal.org documentation if you want to. Repeat: we encourage everyone to contribute to drupal.org documentation if you want to.
Linda
speaking for Linda, Marie, and anyone else who doesn't mind being here (Which thread was it? someone wrote a post and said something about ducking under the table?)
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site designed to answer the questions of Drupal beginners and intermediate users. It is in a very early stage, but it does have about 300 pages. Quick links to "Modules," and "Example Sites."
Per my previous comment
Per my previous comment above;
Anyone who wants to write a page on a contrib module for the handbook would place it here:
http://drupal.org/handbook/config/contribmodules
We have repeatadly told many people this who have asked and many how have not. Your account is 2 days old. I must assume that it is a new account and you formerly contributed under a different psudonymn. The point of unfinished pages is?
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide
misinformation
Linda,
In reference to your other comment, prior to February (I can't speak about since) there were never "200 pages or so waiting to be approved." There have been very many pages on numerous occasions where documentation team members were working on pages that they were not personally (because they were the creators) prepared to put into the hanbooks--thus they were in moderation. People with moderation privileges sometimes use that space as a scratch place to prepare documents. Then there are the pages which definitely need work before being added. Don't make it sound like there were all of these wonderful documentation texts just waiting for approval to be posted to drupal.org. If you want to learn something about documentation development on drupal.org, there are better ways than leveling accusations.
So if you don't want to work with the doc team, then don't work with the doc team. If you don't like the documentation on drupal.org, then don't like it. If you want to promote your project so that you can build a reputation as a Drupal ecommerce expert, that's fine. But at least give the professional respect you say in these threads that documentation people on Drupal deserve by choosing to either know what you are talking about or not saying anything. I'm not saying this because I'm personally offended, but I am concerned that drupalecommerce seems very bent on discrediting the documentation effort in this discussion in the interests of promoting their own project. And I am definitely concerned that drupalecommerce will be some fly-by-night project that will die out in six months, in the meantime discouraging work here that will need to continue long after you are gone and long after I am.
storing notes
we have websites to make. we have to figure out the best modules to use. we want to keep track of bugs/problems we want to steer clear of. we have to organize the notes in a way that's easy to find. we have to keep track of how we do something, so that we can remember how to do it when we make a similar website. in order to keep track of these notes, we elected to use the cms called Drupal. to organize these notes in categories that make sense to us that we can find them, we have to do it on a separate site. because we are most interested in ecommerce sites, we are paying special attention to information pertaining to ecommerce and Drupal.
We thought we might as well open it up to the public, so that the documentation team does not have to answer the same question over and over and over and over again, to make their lives easier.
we encourage everyone to contribute to drupal.org documentation
we encourage everyone to contribute to drupal.org documentation
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site designed to answer the questions of Drupal beginners and intermediate users. It is in a very early stage, but it does have about 300 pages. Quick links to "Modules," and "Example Sites."
Linda et al, I don't see
Linda et al,
I don't see why you have to be so apologetic about what you are doing, considering you have done a very useful job so far. And, going by the general spirit of your responses, it seems reasonable to assume that you will contribute much of that documentation back to the drupal.org handbooks as and when the doc team finds any useful stuff that it would like to feature back here.
I hate to get into an argument, but, I frankly think you are getting unnecessary flak for the good work you have done and having ulterior motives imputed to you.
wow
so i get the feeling that the heated conversation that started when some of the drupal.org documentation team entered my thread is just a continuation of a land standing friction that's gone on for a while. not sure if i completely follow, but it's interesting and has definitely given me a better understanding of the differing views that are within the drupal community. *shrug*
thanks for all of the feedback about the issues i've raised. it's definitely allowed me to get a better perspective of the true nature around here... i've started to look at things with the "techie-to-techie" viewpoint and it's made sense. i see that drupal isn't made for "customers" or end users as much than for down in the trenches techies - code needs changed to fit your needs, there's gonna be bugs, things aren't going to work - we all pitch in to fix things and point each other in the right direction. in that vein, for example, i've gone back and answered many of my own threads when i ended up finding something that worked for me, etc. it's also made me a lot less frustrated :)
- Jason
It's not long standing.
It's not long standing. It's when people make false claims and tie to specific names it tends to get attention.
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain
-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide
explain please
who made what false claims?
you've got the right idea
More people should post their solutions in the forums. That's a good strategy. And if you feel like some of your solutions should be documentation, create docs for them :)
Good to hear...
I'm glad its worked out for you, Jason. For a brief moment I thought you'd be scared off by the vehemence of the responses here. You can't say people aren't passionate about this CMS!
nah...
i can see through the passion and emotion and try to understand the differing viewpoints. people just want to be heard. i just think that it's human nature to not realize that there's a difference between understanding vs. agreeing. healing and compromise comes from saying "i truly understand you, but I disagree with you".
- Jason
I have been with drupal for
I have been with drupal for almost 18 months now and I can assure you that the documentation is not intentionally skimpy to drive users to the consultants. Yes, some consultants I approached quoted prices that sent me scurrying for cover, but it is their prerogative and the ultimate decision to hire them is mine, so I always have the choice, after all.
That said, I agree with you about the absence of tutorials that tie things together for non-tech kind of people. But, even this is starting to happen. Just today, merlinofchaos posted a brief, but very useful article about modules that can be used for a publishing scenario. Another recent one that similarly tied things together was Zacker's screencast about Organic Groups. And, the folks at lullabot.com have been regularly publishing podcasts of various things drupal. Yet another is the www.cookingwithdrupal.org site that has a few recipes that tie things together.
So, as you can see, there are efforts all over the place and many/all of these will ultimately (Edit: hopefully) end up in the drupal.org handbooks. I and other users can tell you how dramatically the handbook section of drupal.org has improved in recent times.
It's time for a possible solution...
I'll throw out there the idea that i'm sure it's been talked about before but I don't know where it stands. A FAQ page that's linked to right from the main drupal.org page. The front page will have a big logo that says something like "Check here if you're new to drupal or the Open Source community."
Then the FAQ will explain some of the issues that we've been talking about to death around here... like the drupal community being "techie-to-techie" and that it's expected that you pitch in when it comes to the drupal community, where to find the most important documentaiton, etc. we can evolve the details but let's talk about doing this for real.
It should be so solid that every time someone bitches around here about the community we just politely point them to the faq and THEY'RE SATISFIED OF THE ANSWERS IT HAS. Not everyone will be happy, but as long as the majority are satisified - that should be the goal.
What does everyone think and who do we need to get involved to make this happen?
- Jason
getting involved in documentation efforts
The best way to get involved in documentation efforts is to join the documentation list. That's the most productive venue for discussions about adding documentation on drupal.org.
But before you do that, you might want to look through the Drupal handbook. Start with the Drupal.org REAME first. Get to know what documentation is already available that does some of what you describe. Come up with solutions that build on or make use of documentation. Think about what needs to be done to revise existing documentation. After all, adding new pages is not always the best solution.
definitely...
definitely... if the FAQ-esque documentaiton i'm envisioning already exists then the only issue is putting a nice big icon on the front page to link to it. if the FAQ doesn't exist then obviously we need to create it first. you're totally right - we don't want to reinvent the wheel if the documentation already exists. thanks for pointing me in the direction of signing up with the documentation list group.
- Jason
seems like discussion is headed in a productive direction
Ramdak, thank you for your support. We do appreciate it.
Sepeck,
There was never any attention to attack you or anyone else. We apologize if you or anyone else felt attacked. We think you are terrific and that you are doing great under challenging circumstances of high demand and low resources. (We felt attacked, but we'll try to write this off to a misunderstanding on the part of people who are all well-intentioned.)
Someone on the developers mailing list has offered to donate money. That person has been pointed in a variety of directions. Perhaps you can write to the person (or coordinate with Dries) to have some of the money go toward documentation.
It seems like the discussion is headed in a productive direction so we won't write anything else that could be misunderstood.
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site written using language that Drupal beginners and intermediate users can understand. It is in a very early stage, but it does have about 300 unfinished pages. Quick links to "Modules," and "Example Sites."
I have been using Drupal for
I have been using Drupal for only 3 months. I entirely agree that it is a bit tough for a newbie and I had my whinge about that. On the one hand I think it is fair and reasonable that a bunch of techies collaborating on some code should not feel obligated to cater for a "customer" when they ask for and receive nothing. On the other hand, three points: (1) when you put something in the public domain you take on a moral obligation to those who adopt it and (2) when this much effort has been invested in something I for one would want to see it thrive and (3) some of those non-customers are sites who provide a public service (or *shudder* actually make someone a living) so Drupal matters, it isn't just a fun hobby any more.
So that's my view of the big picture. On this particular issue, I had some suggestions of my own re the documentation and i found Steve and co open to my views and all too eager to adopt my humble initial contribution. I do however sense in the Drupal community the disinterest in non-technical or newbie users (except for the excellent work Heine and co do in the forums but that is kinda picking up the pieces afterwards not addressing the problem). E.g. I recently ranted against the anti-IE mindset some have.
I think some of the broader disconnect stems from new-user expectations. I thought it would be a few days to set up my Drupal site. There goes that Windows-user setup.exe mindset. It has been a couple of months now working 12-16 hour days and I'm finally about to test a live site. i had to learn it all (what's PHP?) so it took a while but I am technical enough to have coped (with lots of help from the forums).
I sold commercial software for 20 years and I am building my new business in open source. Why? because i think the support I get is superior: faster and more helpful and unconstrained by liability and other corporate BS. And if support can't help me, i can get the bonnet up and look for myself and fix it in the source. And the result is EXACTLY what I want because i built it. If I buy a package there is compromise everywhere and never 100% fit to requirements.
I understand now that the price i pay for that is the climb of the learning curve and the time I invest. Given the time i have invested i think Drupal has been several times more expensive than a Commercial Off-the-Shelf package but the result (and the fun along the way) justifies the investment. If i had understood from the start what i was getting into I would probably do it again, but I wish it had been explained to me. So new users need to understand:
# open source is hard - even if some projects might make it easier than Drupal does :-)
# open source requires you to learn everything
# you are a developer and a collaborator not a customer
# you better have the ability to learn and to cope with the technical material (if you dont, then buy COTS or pay a consultant)
In return you get something entirely different to a bought product.
And Drupal owners need to understand that new users are the lifeblood of the project, and the experience is overwhelming and a bit frightening for most, and a little more TLC wouldn't go amiss. I for one don't want to end up built on some back-water technology that no-one supports or contributes to any more. Drupal is one of the leaders right now - I hope it stays that way.
Also the amount of effort that has gone elsewhere shows that some fine tuning is needed in the culture to keep this thing together. As the community grows we risk alientating more groups if the culture doesn't grow to embrace the increasing diversity.
Focusing on the somewhat heated immediate issue, I'd say that having shown what can be done in the external site i hope we can all play nicely now and roll this stuff back into core just like the best modules. I feel the effort would be better invested in the home project and the last thing we need is a split.
It's free!
I have to say that I have used a lot of GPL software in my day. I have just installed Drupal in the last week. Yes, the nodes and where to set what is pretty confusing. A simple road map would be nice. But, no one charged me a big fee when I downloaded it! The guys developing this software spend precious time doing it.
Sad to say, but updating documentation is usually at the bottom of the list of priorities for any GPL. Time gets taken up by development and security issues.
I, personally, have been able to find all the answers I need to my questions by using the Drupal search engine. Sometimes I find the answer promptly, sometimes it takes a little digging. And I am still confused by all the module setting, where they are, and what they do. But, I am sure, like any other comprehensive packaged I have worked with; I will get used to this one.
If you want good documentation, you can volunteer you time to that area of the project.
I am impressed with the ability to update and add functions so easily. Thanks to all that have worked, and are working, on this project!
Take Care, Sharon
views tutorials submitted
The 2 tutorials for views have been submitted to drupal.org documentation.
http://drupal.org/node/47845
The original tutorials are here
http://www.drupalecommerce.com/node/141
-----
Drupal ecommerce, at www.drupalecommerce.com is a new site written using language that Drupal beginners and intermediate users can understand. It has about 300 unfinished pages. 2 tutorials for views module under "Modules"