<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META http-equiv=Content-Type content=text/html;charset=Windows-1252>
<META content="MSHTML 6.00.6001.18226" name=GENERATOR></HEAD>
<BODY id=MailContainerBody 
style="PADDING-RIGHT: 10px; PADDING-LEFT: 10px; PADDING-TOP: 15px; WORD-WRAP: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space" 
leftMargin=0 topMargin=0 CanvasTabStop="true" name="Compose message area">
<DIV style="FONT: 10pt Tahoma"><FONT face=Arial>Going through these documents, I 
can find allot of "out of scope" information.&nbsp; I think we can trim out this 
information to make these documents shorter.&nbsp; People don’t want to read 
long documents, and do not.&nbsp; Please see <A 
title="http://drupal.org/node/446654#comment-1526984&#10;CTRL + Click to follow link" 
href="http://drupal.org/node/446654#comment-1526984">http://drupal.org/node/446654#comment-1526984</A>&nbsp;for 
an example of were I think this is pushing the limits of what is in scope.&nbsp; 
In fact allot of this information has nothing to do with CVS access at 
all!</FONT></DIV>
<DIV style="FONT: 10pt Tahoma"><FONT face=Arial></FONT>&nbsp;</DIV>
<DIV style="FONT: 10pt Tahoma"><FONT face=Arial>This document maybe moved, but 
it wont ever be deleted.&nbsp; It needs allot of attention and the hand of a 
true writer.</FONT></DIV>
<DIV><FONT face=Arial></FONT>&nbsp;</DIV>
<DIV><FONT face=Arial size=2>It is clear that there is some frustration over the 
application process for CVS access.&nbsp; That people are not reading it 
all.&nbsp; Yet bloating the document makes things worse, not better.&nbsp; We 
need the best of the best of the Doc Team to come in and re-do this.&nbsp; A 
good writer will say more in less words.&nbsp; I tend to try and write more to 
cover all aspects of a topic.&nbsp; Thus I tend to bloat a document to include 
things that maybe obvious to others.</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT>&nbsp;</DIV>
<DIV><FONT face=Arial size=2>In the end, the person maintaining CVS access will 
always get bad CVS requests.&nbsp; I feel this is a crucial area of Drupal that 
requires a person who has a very patient attitude.&nbsp; Getting people to 
Contrib. is probably one of the most important aspects of the website and 
community.&nbsp; I will ask that I am not apart of the people who review's these 
requests because I know I have the patience of a (thinking of some analogy)... 
Spitting Cobra!&nbsp; A-HA!</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT>&nbsp;</DIV>
<DIV><FONT face=Arial size=2>Mike</FONT></DIV>
<DIV style="FONT: 10pt Tahoma"><BR></DIV>
<DIV style="BACKGROUND: #f5f5f5; FONT: 10pt Tahoma">
<DIV style="font-color: black"><B>From:</B> <A title=drupal@rocktreesky.com 
href="mailto:drupal@rocktreesky.com">Addison Berry</A> </DIV>
<DIV><B>Sent:</B> Monday, April 27, 2009 5:07 PM</DIV>
<DIV><B>To:</B> <A title=documentation@drupal.org 
href="mailto:documentation@drupal.org">A list for documentation writers</A> 
</DIV>
<DIV><B>Subject:</B> Re: [documentation] Proposal of HandBook and CVS 
documentationchanges!</DIV></DIV>
<DIV><BR></DIV>Yeah, this stuff has been in need of a "do-over" for a while 
generally. I will say though that these *were* more consolidated when the 
Getting Involved book was created. I have reverted the moves that have happened 
since then to re-consolidate them, for the time-being. That is, I have moved 
Drupal and CVS back to the Getting Involved guide, and I moved the 
Start/Maintain a Module back under the Contribute Code section.&nbsp;We 
definitely have some large architectural issues in the handbook and we also do 
not have any clear way to "control" it, even if we set it, since different 
people see things being organized in different ways and we have no restrictions 
on book organizational changes at the moment. 
<DIV><BR></DIV>
<DIV>I would ask that folks hold off making big location changes in the 
documentation for the time-being, unless it is discussed on the list or in an 
issue in the doc queue first, with broad&nbsp;consensus&nbsp;that it "just makes 
sense." The reason for this is that I will be making a really big announcement 
in the next two weeks about the overall docs roadmap and one of the biggest 
pieces of that will be the IA (information architecture) of all Drupal docs. We 
have an IA person who has volunteered to lead the project (and everyone will be 
encouraged to be a part of it). Once we get some preliminary stuff taken care of 
and I can articulate all of this stuff in a meaningful way about how we can move 
forward, I'll be posting to the doc list and then making a front page post on 
Drupal.org.</DIV>
<DIV><BR></DIV>
<DIV>Mike, thanks for bringing this up, as it is very important and something we 
need to really figure out a long-term solution for, so I hope you will keep 
digging in to this and giving us feedback.</DIV>
<DIV><BR></DIV>
<DIV>Thanks all :-)</DIV>
<DIV>Addi</DIV>
<DIV><BR>
<DIV>
<DIV>On Apr 27, 2009, at 4:38 PM, Mike Parisi wrote:</DIV><BR 
class=Apple-interchange-newline>
<BLOCKQUOTE type="cite">
  <DIV id=MailContainerBody 
  style="PADDING-RIGHT: 10px; PADDING-LEFT: 10px; PADDING-TOP: 15px" 
  name="Compose message area" leftmargin="0" topmargin="0" canvastabstop="true">
  <DIV><FONT face=Arial size=2>I know this post wont be perfect, and I don’t 
  mean to insult anyone.&nbsp; If I do its completely unintentional and due to a 
  statement that was probably a bit skewed.</FONT></DIV>
  <DIV>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2>I have been beating my head over CVS for 
  MONTHS.&nbsp; Partially because the documentation is scattered and not 
  organized.&nbsp; Often times you read a document and it mentions allot of 
  specifics (But not all)&nbsp;about CVS.&nbsp; What you need is missing, for 
  example a major document on CVS contribute does not contain other CVS 
  utilities, while these are located in another section of the site.&nbsp; This 
  leaves the reader feeling empty and also leaves us not looking 
  elsewhere.&nbsp; This also bloats pages so that users feel daunted by the 
  tasks required.</FONT></DIV>
  <DIV><FONT face=Arial size=2></FONT>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2>I propose a major change in the structure of 
  these sections for many reasons.&nbsp; The most prominent one is that the 
  information is scattered across 3 separate area's!</FONT></DIV>
  <DIV>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2><A 
  href="http://drupal.org/node/10259">http://drupal.org/node/10259</A><BR><A 
  href="http://drupal.org/node/7765">http://drupal.org/node/7765</A><BR><A 
  href="http://drupal.org/handbook/cvs">http://drupal.org/handbook/cvs</A> 
  </FONT></DIV>
  <DIV>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2>I think that many of these pages are bloated 
  duplicate information and thus are not read!&nbsp; This is evident in the <A 
  title="http://drupal.org/cvs-application/requirements&#10;CTRL + Click to follow link" 
  href="http://drupal.org/cvs-application/requirements">http://drupal.org/cvs-application/requirements</A> 
  contains the following statement: </FONT></DIV>
  <DIV>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2>"If you just scrolled down this page to the apply 
  link and didn't read the page, don't expect to get a CVS account. It seems 
  many people are doing just that and submitting poor motivation messages 
  resulting in a high decline rate."</FONT></DIV>
  <DIV>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2>Well this is probably because people can not find 
  the information they need, and the page contains everything from CVS 
  information to Coding Standards information.&nbsp; I will fix a few problems I 
  have found with the current structure, but this is very complex set of 
  documentation with allot of overlapping information and unclear 
  navigation.</FONT></DIV>
  <DIV>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2>One proposal is that much of the information 
  should (or is) included in the <A 
  href="http://drupal.org/handbook/cvs">http://drupal.org/handbook/cvs</A>, and 
  removed from the handbook.&nbsp; Instead a sub page in the handbook that 
  specifically talks about CVS and Coding Standards should be added to the 
  handbook.&nbsp; That adds a quick over-view of why CVS and Coding Standards 
  and where to find the information needed.&nbsp; It is important </FONT></DIV>
  <DIV>&nbsp;</DIV>
  <DIV><FONT face=Arial size=2>Finding the documents is confounded because 
  Druplicons "cvs?" command is unclear at best and does not include all three 
  links above.</FONT></DIV>
  <DIV><FONT face=Arial size=2></FONT>&nbsp;</DIV></DIV>--<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>
<P>
<HR>

<P></P>--<BR>Pending work: 
http://drupal.org/project/issues/documentation/<BR>List archives: 
http://lists.drupal.org/pipermail/documentation/</BODY></HTML>