Hey All,
I'm happy to be able to make this contribution to telling the Drupal story. As mentioned previously, my hope is to use my Drupal Noob superpowers to add some "ignorant outsider" perspective to the mix and hopefully generate something that will connect with those sniffing around the periphery of Drupal. I know this is precisely the sort of thing I was looking for when I first dug in a few months ago. What I'm submitting is the sort of thing I typically do for my clients, where I draw out the essence, and articulate a summary that creates the framework for understanding and approaching something for an audience that is unfamiliar with it.
My thought is that this would works nicely as both an intro section to the install & config manual, as well as being used on the site to give people their first encapsulated dose of "What is Drupal?" when they are still in either decision-making mode, or they are getting ready to jump in and swim.
This was written in the voice you often find in third party technical manuals (like O'Reilly's stuff) so it's intentionally chatty and conversational in tone. The intent is that it would hopefully go down like ice cream, and get people over the stigma of "Drupal is Hard". It is also specifically written to be very welcoming to non-technical people, so that more designers, user experience creators, information architects, and even marketing directors might get jazzed about Drupal and continue to round out our community with more non-geeks.
Anyway.. enjoy, and I look forward to your feedback.
On another note, is there a way to have this thing email me when I get a response so I don't have to keep manually checking back here?
| Comment | File | Size | Author |
|---|---|---|---|
| #5 | drupal overview.zip | 29.01 KB | nitrospectide |
| The Drupal Overview [1.3].pdf | 473.07 KB | nitrospectide |
Comments
Comment #1
nitrospectide commentedOh, and of course, being a noob - some of the stuff I wrote may not actually be accurate (I gave it my best go). Any technical editing feedback is greatly appreciated.
Comment #2
add1sun commentedAwesome! Thanks for he contribution. I'll try to get a look at it in the coming week. Just wanted to answer your email notification question. You can subscribe to various issue queues by clicking the Subscribe link at the top of the queue page. So if you go to the Documentation queue (http://drupal.org/project/issues/documentation) and click Subscribe you can set it up the way you want it.
Comment #3
sepeck commentedI missed this earlier. Where in the handbooks / drupal.org do you see it's placement?
Comment #4
sepeck commentedActually, never mind. Can we get the text files/images in a non pdf format as well? I had a thought for the /handbook page itself that this may just right for.
Comment #5
nitrospectide commentedMy thought is that this overview is useful as a conceptual onramp for people who are trying to do a first pass at getting their head around Drupal. It would be useful in at least a couple of key spots in the overall Drupal Experience. The first spot is somewhere up front as part of a set of things someone could easy notice in their first visit to D.O. This is for the person who has heard of Drupal, and is wanting to look into it and see if it's a fit for their project. They're not digging into the labyrinthine bowels of the handbooks, or reading through long PDFs, they just need a preliminary understanding of What is this Drupal thing? How does it approach the task of getting stuff done? How is it different than XYZ CMS? Additionally, by injecting this framework of understanding into their thinking, everything else they read could jump up significantly in value because they have the 'legend key' to read the maps. Anyway, this level is in the Marketing/Communications arena where the focus is on connection and conversion of the "Drupal curious" to the "Drupal user".
The other spot is in the beginning of the documentation, where someone has presumably made a decision to at least try Drupal. Here, it would not just tell them how to set up a site and configure settings, but give them clarity on the conceptual underpinnings that drive being good at working with Drupal. Then, when they read the blow-by-blow setup/config walkthrough, and the tasty breakouts on some of the other concepts (as provided by Eaton and others in the new manual you were pulling together), there's an overarching context that helps them digest those things more quickly and fully and be thinking about how to move forward. The "Deprecated" Lullabot podcast kind of hits this issue - where it becomes evident halfway in that there is a mind-shift happening towards more abstracted tools, and away from more specialized way of doing things. That way of looking at Drupal is not immediately evident just by looking at things like core, modules, etc. It's an interpretational overlay. An overlay like that turns knowledge into understanding. It's my hope this overview could take a whack at providing that for prospective and actual users in order to click them in to the right way of looking at everything.
As I recall, the spot I had thought would be best was the place where the pdf you had made had the Content Management Framework thing called out - somewhere in the first couple of pages – so it laid groundwork before they read anything else.
Html and gif image attached (what is the preferred format that preserves semantic bolds, italics, and image placement?)
Comment #6
sepeck commentedI disagreed with about half that 'deprecated' podcast but that's all right.
HTML tags...... Not sure what you mean. The web format does result in some slight formatting differences. My thought was an HTML version and a PDF version. I hope to have a few hours this weekend to work on the /handbook page.
Comment #7
nitrospectide commentedWasn't this supposed to go through technical editing with Add1sun or Webchick? Surely I didn't generate a spot-on accurate piece in my first go? I thought for sure there were bits that needed hammering yet.
Comment #8
sepeck commentedThey have time to comment before this weekend. I am not so bad at reviewing myself either. It's an overview. And we can tweak them as we go.
Comment #9
add1sun commentedSorry I am on the road right now but I actually did have some feedback on this that I never got the time to sit down and articulate. I probably won't be able to focus on this until sometime next week. I'm sorry I just haven't gotten to this yet. :-(
Comment #10
sepeck commentedok. I'll wait till you get a chance to review it.... also, am buried at work currenlty.
Comment #11
leehunter commentedIt might be useful to call this a "white paper". That would help people (or at least people who are used to reading white papers) identify the kind of content that is being presented.
Comment #12
nitrospectide commentedLee,
I would agree. Is the term "whitepaper" used anywhere else in the Drupal communications world? Using the term would help click in with business communication standards. Are there other existing things that would group together under that umbrella? It would certainly help call this sort of material out for people in that decision-making mode.
Comment #13
sepeck commentedWe've not had people submit documentation I would consider 'white papers' before. So I have no objection to the term used here. I'd like more people to submit 'white papers'.
Comment #14
highermath commentedI think that a white paper should contain authoring and sponsorship (if any) information. Most white papers these days are sponsored by some agnecy with an ax to grind. Since yours, presumably, isn't, you should state that it is an independent review.
Comment #15
add1sun commentedI think we need to just get this puppy up there. I do have feedback (myself and from a non-Drupal person) but I don't have the time to really tease it all apart. The base document is a good starting place and the value we get from putting it out there way outweighs quibbling for now.
I'd say we should put it up in the Getting Started section with handbook pages (it should be a section with a few pages - that is too much for all one handbook page) and have the complete PDF available for download on the first page. Seems like the consensus to have White Papers so should we make a White Papers section? Should it go at the top level for Getting Started or under one of the existing sections, Projects and Features or Before you Start?
Figure out where it should go and I'll add it this weekend.
Comment #16
sepeck commentedI have time Saturday to work on this so I will put it up then.
Comment #17
nitrospectide commentedHey - sweet. I was just thinking about this. If you guys need anything, email me.
I feel like I'm in an old Schoolhouse Rock episode, and my bill is about to become a law :)
Comment #18
nitrospectide commentedPer the decisiosn made on this, I went ahead and dropped the page in here:
http://drupal.org/node/265726
Add1sun was kind enough to assist on the weighting.
Comment #19
Anonymous (not verified) commentedAutomatically closed -- issue fixed for two weeks with no activity.