[documentation] does this seem funny to anyone else?

[Bill Fitzgerald]

Hello, Ricco,

I'm glad to see you taking an interest in improving the docs -- I've 
seen your posts on g.d.o regarding wikis, etc.

Like another responder, I'm responding quickly here, but a couple things 
stand out:

First, good info on joining the docs team is two clicks away on *any* 
page on Drupal.org -- click the "Contribute" tab, and then the 
documentation link (which appears on the first screen) -- this gets you 
to: http://drupal.org/contribute/documentation

Second, information about joining the docs team can easily be found 
here: 
http://www.google.com/search?&q=join+documentation+team+site:drupal.org

Third, there is a long history/conversation regarding docs, wiki format, 
wiki syntax, etc: see 
http://www.google.com/search?&q=wiki+style+documentation+pages+site:drupal.org 
for an overview -- these pages might provide some helpful context.

Fourth, in my experience bringing a variety of sites live within 
educational contexts (and here I'm specifically referring to Drupal, 
Moodle, and Mediawiki sites), users frequently expressed frustration 
with wiki syntax. They wanted a wysiwyg, and didn't really care about 
being able to create pages by linking to an empty page. PBWiki came to a 
similar conclusion, and they experienced a boom of new membership when 
they added a text editor to their application.

I'm glad to see you getting interested and involved, and welcome to the 
work of continuing to improve the docs.

Cheers,

Bill

ricco at webulite.com wrote:
> lol... this kind of cracks me up. In a frustrating kind of way :)
>
> Instead of getting OKed to create about the 265th group,
> http://groups.drupal.org/WikiHelp
> 1) to promote the wiki content type
> 2) that can be edited with one click
> 3) and promote [[freelinking]] syntax
>
> The recommendation seems to be;
>
> 1) join the Drupal doc team which is somewhat difficult to find and join,
> and make changes that others will not be able to change unless they also
> join the drupal doc team, which again, is not even know by most people.
>
> 2) so that I can make content type BOOK page that I do not want to promote
> instead of the content type WIKI content type that I do
>
> 3) and use a syntax I don't want to promote, FILTERED HTML, instead of the
> FREELINKING syntax I want to promote.
>
> 4) to build pages that anyone that views them will never be able to change
> with one click (like wiki pages), and will probably never realize they
> might also be able to change, if they can find how to join the doc team
> themselves, and wanted to take the time to do so. So I am not building a
> community where people EASILY change pages I have started
>
> 5) So that that I can build karma with Drupal
>
> 6) so that Drupal might consider changing their system to add allow wiki
> content types on drupal.org some day
>
> 7) so that I can do what groups.drupal.org does today and I have already
> created in working form.
>
>
> Does this seem kind of funny to anyone else?
>
> Cheers! Ricco
>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>
>   


-- 
Bill Fitzgerald
http://www.funnymonkey.com
Tools for Teachers
503.897.7160