FWIW I just finished a HUGE tidy of the D7 install guide last night (except for the multisite section) that I'd been working on for about a month. It is in infinitely better shape now but definitely needs a little more work and then some more reviewing. (All my notes are on the issue <a href="http://drupal.org/node/538054">http://drupal.org/node/538054</a>.)<br>
<br>The critical D7 to-do list jennifer and I have been keeping up to date is here: <a href="http://drupal.org/node/515870">http://drupal.org/node/515870</a>.<br><br>The highest priority task is updating and writing the missing API docs. Next is all the D7 handbook work (install and upgrade guides, and docs for the new modules).<br>
<br>A side not, I got "permission" as such from Earl (merlinofchaos) to tidy and update the views section of the handbook (most of their real docs are in advanced help, but the handbook section has become a dog's breakfast and needs work). So that's marginally on my radar of medium priority.<br>
<br>Most module maintainers are thrilled to have even semi-complete docs dropped in their laps for a review. If uncertain, ping them on IRC or by email and collaborate.<br><br>I know maybe recognition is a big motivator for some, but I think we have to somewhat focus on why we're really doing this - because we want to help people use and create Drupal. And the way we do that is just to take initiative and GSD (pardon my language, Get Shit Done). <br>
<br>Once we've got the critical D7 stuff off our plates, we can refocus on <a href="http://docs.drupal.org">docs.drupal.org</a> and other improvements such as how to give credit.<br><br>A.<br><br><br><br><div class="gmail_quote">
On Mon, Feb 1, 2010 at 6:12 PM, beckysue sh <span dir="ltr"><<a href="mailto:bekasu@gmail.com">bekasu@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
I'm taking a walk on the wild side.<br>
<br>
I owe clean up on d7 installation directions.<br>
I owe clean up on d7 upgrade directions.<br>
I owe jhodgdon two patches on drupal core now that I am less ignorant<br>
of how to run eclipse.<br>
<br>
I took a side jaunt over into the biblio module to write up<br>
documentation for advanced help and integrate it into their 6x2dev<br>
version.<br>
I'm currently developing a biblio companion module (biblio<br>
collections) based on cloned code from another module.<br>
<br>
I agree completely that it takes different personality types.<br>
Offering to provide advanced help integration into a module was very,<br>
very well received. While I'm not sure we can convince a<br>
'programmer' to write documentation, this particular one (rjerome) was<br>
very willing to critique things once the docs were provided. He also<br>
asked questions about biblio docs on d.o., organization of same,<br>
enhancements to it, etc. He also pointed out he didn't have edit<br>
access to the biblio documentation pages on d.o. since things have<br>
begun moving around.<br>
<br>
Perhaps we could consider mini-sprints for incorporating advanced help<br>
into contributed modules as a segway into engaging the contributor<br>
module owner into helping with docs.<br>
<br>
We also did a survey last year (2009) regarding how to say thank-you<br>
on drupal. I analyzed the info and sent it to add1sun just before she<br>
needed a break to handle personal stuff. Perhaps we should revisit<br>
that as well.<br>
<br>
bekasu<br>
<div><div></div><div class="h5"><br>
On 2/1/10, Ariane Khachatourians <<a href="mailto:arianekhachatourians@gmail.com">arianekhachatourians@gmail.com</a>> wrote:<br>
> As much as I really do agree that it would be great to have some more formal<br>
> acknowledgment, and that it should certainly be a consideration as maybe<br>
> another phase of the redesign and development of <a href="http://docs.drupal.org" target="_blank">docs.drupal.org</a>, in the<br>
> meantime, I think it's a bit of a matter of self promoting.<br>
><br>
> - List your contributions on your d.o profile<br>
> - Blog about your achievements<br>
> - Add it to your bio on your company's website<br>
><br>
> And never negate the worth of Drupal karma - I have seen my perceived worth<br>
> and the amount of respect I get in the community grow significantly through<br>
> working on docs.<br>
><br>
> But yes, let's put that on the agenda of things to work out - why not file<br>
> an issue?<br>
> A.<br>
><br>
><br>
><br>
> On Mon, Feb 1, 2010 at 5:36 PM, Shai Gluskin <<a href="mailto:shai@content2zero.com">shai@content2zero.com</a>> wrote:<br>
><br>
>> Folks,<br>
>><br>
>> Re: Josh, given that at your first glance you thought there was a security<br>
>> problem... even though it was from not reading thoroughly, I'm concerned<br>
>> othes will read similarly. So I changed some the intro to the following:<br>
>><br>
>> An alternative, detailed here, is for the *site developer* to place PHP<br>
>> code into the "PHP Code" fieldset below the allowed values box on the<br>
>> textfield set-up page in order to populate the list by parsing the text<br>
>> stored in a node.<br>
>><br>
>><br>
>> I've removed the credit at the bottom.<br>
>><br>
>> But it raises a larger issue... which is how to promote more documentation<br>
>> writing within Drupal.<br>
>><br>
>> By comparison... let's look at developers in the Drupal ecosystem... For<br>
>> those who want to get at the heart of the beast, who have LOTS of patience<br>
>> and not much interest in getting credit, there is Drupal core. For those<br>
>> who<br>
>> want to be in charge, have less patience and want to be king of<br>
>> something...<br>
>> they can be involved in module development. Some folks do both, but it<br>
>> seems<br>
>> like there is a personality difference in the two types of people. So the<br>
>> question is, "How can we make writing documentation more motivating form<br>
>> more people to want to participate?"<br>
>><br>
>> Shai<br>
>><br>
>><br>
>><br>
>><br>
>> On Mon, Feb 1, 2010 at 8:12 PM, Ariane Khachatourians <<br>
>> <a href="mailto:arianekhachatourians@gmail.com">arianekhachatourians@gmail.com</a>> wrote:<br>
>><br>
>>> Just had a skim.<br>
>>><br>
>>> I would agree and say it's pretty well a policy not to credit yourself on<br>
>>> the pages (though I would keep the links to the other two pages if they<br>
>>> are<br>
>>> useful as references). It does indeed discourage others from updating the<br>
>>> pages, and sort of clutters up the pages if a lot of people have worked<br>
>>> on<br>
>>> them.<br>
>>><br>
>>> If people want to know who's worked on pages, all they need to is look at<br>
>>> the revisions tab.<br>
>>><br>
>>> Otherwise, formatting and such looks pretty good.<br>
>>> A.<br>
>>><br>
>>><br>
>>><br>
>>><br>
>>> On Mon, Feb 1, 2010 at 5:10 PM, Joshua Brauer<br>
>>> <<a href="mailto:joshua@brauerranch.com">joshua@brauerranch.com</a>>wrote:<br>
>>><br>
>>>> Um... OK so I didn't read this correctly... The PHP issue isn't what it<br>
>>>> looked like at first glance....<br>
>>>><br>
>>>><br>
>>>> Thanks,<br>
>>>> Josh<br>
>>>><br>
>>>> --<br>
>>>> Follow me on Twitter: <a href="http://twitter.com/jbrauer" target="_blank">http://twitter.com/jbrauer</a><br>
>>>><br>
>>>> On Feb 1, 2010, at 6:01 PM, Joshua Brauer wrote:<br>
>>>><br>
>>>> Any user with the permissions to post PHP code to your site has<br>
>>>> permissions much greater than 'administer content types'. In fact they<br>
>>>> can<br>
>>>> give themselves 'administer content types' permissions should they<br>
>>>> choose<br>
>>>> to.<br>
>>>><br>
>>>> I thought we had a policy against the credit links but maybe it's just<br>
>>>> been a discussion. In short, in my opinion, the credit links discourage<br>
>>>> others from editing pages as appropriate, clutter the page, and become a<br>
>>>> problem as to "at what point when I've edited the page should I remove<br>
>>>> those<br>
>>>> credit links from two years ago".<br>
>>>><br>
>>>> Thanks,<br>
>>>> Josh<br>
>>>><br>
>>>> --<br>
>>>> Follow me on Twitter: <a href="http://twitter.com/jbrauer" target="_blank">http://twitter.com/jbrauer</a><br>
>>>><br>
>>>> On Feb 1, 2010, at 4:53 PM, Shai Gluskin wrote:<br>
>>>><br>
>>>> A friend of mine (he's newish to Drupal, this is his first handbook<br>
>>>> page... go Laurance Rosenzweig @rosetwig) and I wrote a new handbook<br>
>>>> page<br>
>>>> for the Reference: snippets section called, "Managing a CCK allowed<br>
>>>> values list without granting 'administer content types' access."<br>
>>>><br>
>>>> It's at: <a href="http://drupal.org/node/701774" target="_blank">http://drupal.org/node/701774</a><br>
>>>><br>
>>>> Three kinds of feedback would be appreciated:<br>
>>>><br>
</div></div>>>>> 1. Tell me there is a much easier way (I'm dreading this one... hope<br>
>>>> that is NULL)<br>
>>>> 2. Review the handbook page and make improvements (it's directly<br>
<div class="im">>>>> editable by all d.o. users as are other handbook pages).<br>
</div>>>>> 3. Give feedback on the "credits" at the end. Laurance in writing it<br>
<div><div></div><div class="h5">>>>> up listed our names as creators of the tutorial. That's pretty rare<br>
>>>> on<br>
>>>> handbook pages, isn't it? I'm wondering if that is a part of d.o.<br>
>>>> culture<br>
>>>> that might be worth changing. I understand that handbook pages evolve<br>
>>>> with<br>
>>>> their wiki style. But the revisions list preserves that. And module<br>
>>>> pages<br>
>>>> often have "originally written by" lines in them even as the new<br>
>>>> maintainer<br>
>>>> identifies him/herself. What do you think.<br>
>>>><br>
>>>> Best,<br>
>>>><br>
>>>> Shai<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>
>>>><br>
>>>><br>
>>>><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>
>>>><br>
>>><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>
>>><br>
>><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>
>><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>
</div></div></blockquote></div><br>