<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">I responded to the issue in the queue and we should probably keep the conversation in one place rather than splitting it out between the list and queue.<div><br class="webkit-block-placeholder"></div><div>Short responses here:<br><div><div>On Mar 19, 2008, at 7:34 PM, Marjorie Roswell wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">1. I agree with you about the need for improved documentation.<br>2. Totally agree that the book module (the hierarchy that you refer to) doesn't facilitate good documentation. I may have a different reason for feeling that: It's not the hierarchy that I object to: it's just that it is EXTREMELY time-consuming to use the drop-down to enter an item into the hierarchy. I think it's a huge barrier to adding content.</blockquote>Many book pages on drupal.org can and should be added as child pages to existing content so navigating the dropdown should be a non-issue in 99% of cases. That said, yes it is a big usability hurdle and while we keep poking sticks at it, no one has come up with a solid plan for an awesome UI to handle it. It is particularly nasty on d.o because we have such huge books. :-(<br><blockquote type="cite"><br> 3. That said, I'm fairly well-resigned that the powers-that-be will almost never cede the book module model for doing this in favor of a wiki. I've seen it discussed on IRC, and the idea of using a wiki was met with such snideness that I basically resigned myself to living with incomplete documentation forevermore. I wasn't a participant in that conversation, but the tone of it seemed to be: this is how we do things, it isn't going to change.</blockquote>Well wiki seems to mean different things to different people so I'll try to address to 2 big ones.</div><div>1) Anyone should be able to edit: This is the most common thing that people mean when they say d.o should have a wiki. Well anyone can as long as they have a d.o account and simply ask to be on the docs team. We did open it up to "free for all/real wiki style" a while back and got a lot of vandalism that ended up requiring more resources to clean up than benefit gained so we switched it to simply making people ask for the right and it is handed out freely.</div><div>2) Freelinking structure: I think this is the aspect you are more referring to. I dare say responses you have gotten regarding "a wiki" are in direct response to the assumption in 1 above, which was a bad thing in our experience. The freelinking and having a spread out structure rather than a strict hierarchy can have benefits but I'm not sure that works as well in a handbook where folks may need to follow several pages to get a concept from beginning to end. Perhaps I am just not a wiki user so I am not as comfortable with it.</div><div><br class="webkit-block-placeholder"></div><div>If I am totally off here, please do set me right since I feel that I am only guessing at your concerns.</div><div><blockquote type="cite"><br> 4.I don't agree with you about the word "documentation" I think it's a great word. </blockquote><div><br class="webkit-block-placeholder"></div>Yep, this is a recent change since many felt it was a better word than handbook and better for translation.<br><blockquote type="cite"><br>5. Great idea on drupal documentation day. Would be great if you could facilitate it. There was one at DrupalCon, which I was unable to attend, unfortunately.</blockquote><div><br class="webkit-block-placeholder"></div>I'd totally be down with organizing another doc sprint (either physical and online or just online.)</div><div><br class="webkit-block-placeholder"></div><div>- Addi</div><div><br><blockquote type="cite"><br> <br>Those are my thoughts for the moment,<br><br>Margie<br><br><div class="gmail_quote">On Wed, Mar 19, 2008 at 4:13 PM, Nick <<a href="mailto:nickchris@gmail.com">nickchris@gmail.com</a>> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> First, a little background: I've been lurking on the Drupal boards and on this mailing list for some time now. I work for a newspaper in the developing world, and in the near term we will be moving a portion of our online media onto Drupal as a test pilot. For some weeks I had been toying with various CMS, and after settling on Drupal, had to climb up the learning curve from a point where I knew very little about PHP and even CSS, to a point where I can now make my own themes and (very basic) modules from scratch. Throughout this I have become fairly familiar with Drupal's documentation, especially as it relates to a self-starters with a deep interest in Drupal but who lack the immediate technical skills to grasp it immediately. Despite my frustrations with the learning curve, I've become yet another starry-eyed Drupal fanatic, and have big plans for contributing, especially in the area of (translating) documentation.<br> <br>So with that all said: <a href="http://Drupal.org" target="_blank">Drupal.org</a>'s documentation page needs a lot of reorganization. In fact, right now, it seems like a kind of Achilles heel to certain aspects of its development (theming, translations), despite the fact that developers are flocking to it.<br> <br>I posted an issue that I think really captures what I'd like to suggest. You can check it out here:<br><br><a href="http://drupal.org/node/236444" target="_blank">http://drupal.org/node/236444</a><br><br>So what do people think? If not this, what direction will the Drupal documentation take in the future? <br> <br>Last question: if a group of people raised their hands and said that they loved this idea and would do this, what would the next step be?<br> <br>--<br> Pending work: <a href="http://drupal.org/project/issues/documentation/" target="_blank">http://drupal.org/project/issues/documentation/</a><br> List archives: <a href="http://lists.drupal.org/pipermail/documentation/" target="_blank">http://lists.drupal.org/pipermail/documentation/</a><br></blockquote></div><br> --<br>Pending work: <a href="http://drupal.org/project/issues/documentation/">http://drupal.org/project/issues/documentation/</a><br>List archives: <a href="http://lists.drupal.org/pipermail/documentation/">http://lists.drupal.org/pipermail/documentation/</a></blockquote></div><br></div></body></html>