Discussion:
wiki style help pages
r***@webulite.com
2008-04-02 02:33:50 UTC
Permalink
Hello,

I tried to begin a group called http://groups.drupal.org/wikihelp after
someone in the wiki group suggested I start a group.

The group moderators posted me asking for more information about the goals

you can see that response at http://groups.drupal.org/node/10369

I am getting the impression the group I would like to start is not going
to be approved. One of the Drupal Gods posted me and suggested I join the
documentation email list, so here I am.

It seems to me that wiki documentation would be much more useful if it
incorporated wiki functionality. Allowing people (perhaps members only) to
edit pages as wikipedia.org allows, AND allows the freelinking feature to
allow one to include [[page name]] type references. Which are both
currently possible with the groups.drupal.org pages, but not drupal.org
pages which are where the documentation pages seem to be. In addition,
there is no "Edit" tab in Drupal doc pages allowing users to edit them. I
believe Doc editing should be incredibly simple and obvious for even the
most beginning user, if you hope to get your users involved in
participating in documentation. And the wiki environment seems to be such
an obvious documentation environment implementation. Look at the
popularity of wikipedia.org.

I have talked with folks in the IRC chat, the wiki group, and recently
tried to as you see start groups.drupal.org/WikiHelp

Am I barking up the wrong tree? Am I fighting against the philsophy of the
Drupal developer community? If so, I will just fade into the woodwork, and
become a Drupal user, instead of attempting to get involved in helping to
write documentation for the beginner level.

If, on the other hand, there is a wiki project happening, or one about to
happen that I am unaware of... I would appreciate people turning me on to
it. I would be happy to spend time helping to doucment wiki functionality
of Drupal, and even get involved in documenting other non-wiki
functionality of drupal if Drupal is working on any kind of wiki
documentation project. I have worked on documentation and tech writing and
tech support in the past, so I have some experience. I would be willing
and happy to be involved in helping with the very beginning documentation
for beginning users, so that more people that look at Drupal start with
it, instead of turning to a mediawiki install because it seems simple to
get up. In the long run, and even the short run, Drupals permissioning
system make Drupal a superior choice for a wiki implementation, so if we
can make setting up a wiki easier for even the most beginning site
manager, we will capture more initial installs.

I got the time and the interest, if someone can direct me.

Cheers! Ricco



--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Shai Gluskin
2008-04-02 03:54:45 UTC
Permalink
Hi Ricco,

I'm still confused after reading your e-mail which of the following is your
primary passion right now:

a. making Drupal, the software, a really great platform for wiki
implementations

or

b. improving wiki functionality for the documentation sections at Drupal.org
.

Though you can argue that a and b are certainly related, I think it would
help folks to understand which of the two is your first interest in order to
figure out the best way for you to get involved.

As an FYI, in order to see the "edit" tab on documentation pages at
drupal.org, one need only join the documentation team, by submitting a
request at http://drupal.org/project/documentation.

It can be a little tricky figuring out exactly how and where to help in
Drupal, especially at the beginning. But I really hope you figure it out. I
myself am very much interested in developing wiki functionality on a couple
of sites right now and I too think that Drupal can be way more powerful with
easier UI than Mediawiki.

All the best,

Shai
content2zero <http://content2zero.com>
Post by r***@webulite.com
Hello,
I tried to begin a group called http://groups.drupal.org/wikihelp after
someone in the wiki group suggested I start a group.
The group moderators posted me asking for more information about the goals
you can see that response at http://groups.drupal.org/node/10369
I am getting the impression the group I would like to start is not going
to be approved. One of the Drupal Gods posted me and suggested I join the
documentation email list, so here I am.
It seems to me that wiki documentation would be much more useful if it
incorporated wiki functionality. Allowing people (perhaps members only) to
edit pages as wikipedia.org allows, AND allows the freelinking feature to
allow one to include [[page name]] type references. Which are both
currently possible with the groups.drupal.org pages, but not drupal.org
pages which are where the documentation pages seem to be. In addition,
there is no "Edit" tab in Drupal doc pages allowing users to edit them. I
believe Doc editing should be incredibly simple and obvious for even the
most beginning user, if you hope to get your users involved in
participating in documentation. And the wiki environment seems to be such
an obvious documentation environment implementation. Look at the
popularity of wikipedia.org.
I have talked with folks in the IRC chat, the wiki group, and recently
tried to as you see start groups.drupal.org/WikiHelp
Am I barking up the wrong tree? Am I fighting against the philsophy of the
Drupal developer community? If so, I will just fade into the woodwork, and
become a Drupal user, instead of attempting to get involved in helping to
write documentation for the beginner level.
If, on the other hand, there is a wiki project happening, or one about to
happen that I am unaware of... I would appreciate people turning me on to
it. I would be happy to spend time helping to doucment wiki functionality
of Drupal, and even get involved in documenting other non-wiki
functionality of drupal if Drupal is working on any kind of wiki
documentation project. I have worked on documentation and tech writing and
tech support in the past, so I have some experience. I would be willing
and happy to be involved in helping with the very beginning documentation
for beginning users, so that more people that look at Drupal start with
it, instead of turning to a mediawiki install because it seems simple to
get up. In the long run, and even the short run, Drupals permissioning
system make Drupal a superior choice for a wiki implementation, so if we
can make setting up a wiki easier for even the most beginning site
manager, we will capture more initial installs.
I got the time and the interest, if someone can direct me.
Cheers! Ricco
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
r***@webulite.com
2008-04-02 04:28:46 UTC
Permalink
Hi Shai,

I would not call myself a programmer or a developer. I know some php, and
I maintain my Drupal install, and have done some mode... but I am talking
about (B) improving the usability of the drupal documentation. Since I am
a believer and user of the wiki asepcts of Drupal, I choose "Wiki" +
"Help" as the group, I would create. To imply "Help" with the "wiki"
stuff. But, I would be happy to help with documentation of more that wiki
functionality, if the Drupal system would install a wiki, for all their
documentation.

Thanks for telling me that you can EDIT a wiki handbook if you join the
wiki documentation project. That for example is a pretty amazing
revelation. And you would think that instructions to do that would be on
the very first documentation page off the documentation tab.

... but I just went to http://drupal.org/project/documentation per your
suggestion, and I am logged in, and there is no link to join. I did start
following a few links, and headed to here; http://drupal.org/node/23367
and even there it does not indicate how to become a person that get's an
edit tab of doc pages. There is lots of talk about guidelines and how to
"submit an issues", etc... as you say it is a bit "tricky".

The point being, it certianly is not easy... and perhaps that is why there
are only 240+ people on the doc team. Now on mediawiki.org my mother can
figure out how to add a sentence to any page in about 3 minutes. Why can
Drupal wiki's documentation be THAT easy? the more eyes and hands updating
the pages, they better documentation it will become. And it needs to be
Easy and Obvious for even the beginner to do it.

This page; http://drupal.org/project/issues/documentation/ seems the
closest thing I have found to adding to the documentation. and then this;
http://drupal.org/node/240536 which seems to be a form that allows me to
request to join the doc team, but look at the extra pull downs and check
boxes I need to add. i have to decide what part of the team I want to
join, and what functionality I want to add to... god it just seems so damn
complex, certainly not inviting. Does this mean if I pick the wrong
component type that I will not be able to edit other component pages, how
can I pick ALL?

As you can see I am crying out for either direction to the hidden way of
viewing things differently than i have been to see what you see... or
trying to point out, that the documentation system is too complex to be
inviting to get people to join.

Second... do the documentation pages allow FREELINKING, ie [[happy page]]
? I got the impression that this was not supported in the documentation.

I would be happy to join the #drupal-support or some other channel if
someone can walk me though understanding this.

Cheers! Ricco
Post by Shai Gluskin
Hi Ricco,
I'm still confused after reading your e-mail which of the following is your
a. making Drupal, the software, a really great platform for wiki
implementations
or
b. improving wiki functionality for the documentation sections at Drupal.org
.
Though you can argue that a and b are certainly related, I think it would
help folks to understand which of the two is your first interest in order to
figure out the best way for you to get involved.
As an FYI, in order to see the "edit" tab on documentation pages at
drupal.org, one need only join the documentation team, by submitting a
request at http://drupal.org/project/documentation.
It can be a little tricky figuring out exactly how and where to help in
Drupal, especially at the beginning. But I really hope you figure it out. I
myself am very much interested in developing wiki functionality on a couple
of sites right now and I too think that Drupal can be way more powerful with
easier UI than Mediawiki.
All the best,
Shai
content2zero <http://content2zero.com>
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Steve Dondley
2008-04-02 04:41:02 UTC
Permalink
Seems like a simple text link on top of every doc page that said:

"Click here to help improve this document," or something to that
effect, with a link to the appropriate page on how to contribute to
documentation would be nice.

I don't know what the thinking is behind the application for document
contributors is. Perhaps the hurdle is there to improve the signal to
noise ratio?

One thing drupal's wiki feature lack is the ability to send out email
notifications when a page is updated. I think this is a crucial
feature that's needed before opening up documentation to every Tom,
Dick, and Harry who wants to change a page. That feature should
probably implemented before documentation became more open. This would
make catching bad edits more timely.
Post by r***@webulite.com
Hi Shai,
I would not call myself a programmer or a developer. I know some php, and
I maintain my Drupal install, and have done some mode... but I am talking
about (B) improving the usability of the drupal documentation. Since I am
a believer and user of the wiki asepcts of Drupal, I choose "Wiki" +
"Help" as the group, I would create. To imply "Help" with the "wiki"
stuff. But, I would be happy to help with documentation of more that wiki
functionality, if the Drupal system would install a wiki, for all their
documentation.
Thanks for telling me that you can EDIT a wiki handbook if you join the
wiki documentation project. That for example is a pretty amazing
revelation. And you would think that instructions to do that would be on
the very first documentation page off the documentation tab.
... but I just went to http://drupal.org/project/documentation per your
suggestion, and I am logged in, and there is no link to join. I did start
following a few links, and headed to here; http://drupal.org/node/23367
and even there it does not indicate how to become a person that get's an
edit tab of doc pages. There is lots of talk about guidelines and how to
"submit an issues", etc... as you say it is a bit "tricky".
The point being, it certianly is not easy... and perhaps that is why there
are only 240+ people on the doc team. Now on mediawiki.org my mother can
figure out how to add a sentence to any page in about 3 minutes. Why can
Drupal wiki's documentation be THAT easy? the more eyes and hands updating
the pages, they better documentation it will become. And it needs to be
Easy and Obvious for even the beginner to do it.
This page; http://drupal.org/project/issues/documentation/ seems the
closest thing I have found to adding to the documentation. and then this;
http://drupal.org/node/240536 which seems to be a form that allows me to
request to join the doc team, but look at the extra pull downs and check
boxes I need to add. i have to decide what part of the team I want to
join, and what functionality I want to add to... god it just seems so damn
complex, certainly not inviting. Does this mean if I pick the wrong
component type that I will not be able to edit other component pages, how
can I pick ALL?
As you can see I am crying out for either direction to the hidden way of
viewing things differently than i have been to see what you see... or
trying to point out, that the documentation system is too complex to be
inviting to get people to join.
Second... do the documentation pages allow FREELINKING, ie [[happy page]]
? I got the impression that this was not supported in the documentation.
I would be happy to join the #drupal-support or some other channel if
someone can walk me though understanding this.
Cheers! Ricco
Post by Shai Gluskin
Hi Ricco,
I'm still confused after reading your e-mail which of the following is your
a. making Drupal, the software, a really great platform for wiki
implementations
or
b. improving wiki functionality for the documentation sections at Drupal.org
.
Though you can argue that a and b are certainly related, I think it would
help folks to understand which of the two is your first interest in order to
figure out the best way for you to get involved.
As an FYI, in order to see the "edit" tab on documentation pages at
drupal.org, one need only join the documentation team, by submitting a
request at http://drupal.org/project/documentation.
It can be a little tricky figuring out exactly how and where to help in
Drupal, especially at the beginning. But I really hope you figure it out. I
myself am very much interested in developing wiki functionality on a couple
of sites right now and I too think that Drupal can be way more powerful with
easier UI than Mediawiki.
All the best,
Shai
content2zero <http://content2zero.com>
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
r***@webulite.com
2008-04-02 05:02:19 UTC
Permalink
Steve,

What you seem to be saying is that I am not missing something. That I
cannot simply sign up to get a "EDIT PAGE" tab at the top of all doc
pages. Assuming you are familiar with how the doc system works more than
me, and your comment was inspired by my post.

If you go to http://groups.drupal.org/WikiHelp, and follow any link to any
page off the front, you will see they are wiki pages, and anyone then just
clicks EDIT, and edits the page (would be cool if groups.drupal.org wiki
pages had the TALK tab implemented and the wiki page content type had a
default to "enable comments read/write, but that is a future feature, not
one currently implemented in the groups.drupal.org world.) And yes,
mediawiki calls what you are talking about a WATCH LIST, and you can sign
up to monitor pages changes. And of course certain mediawiki gods can see
revisions and undo bad edits.

But you see how easy http://groups.drupal.org/WikiHelp pages are to edit?
That was why I set the group up. I don't see what is unDrupal about it...
in fact it seems to be simply a group like the 260 other groups, that
allows members to create wiki pages like the other groups offer. It seems
kind of odd that the moderators would allow a "spain drupal users group"
or many of the other 260+ groups, but not tolerate a "WikiHelp" group. Not
sure how it can hurt things, and it seems like it would be an
experimentation environment that would help shed light on if the drupal
doc group is not getting members because it is too hard to work, or if
simply nobody care about documentation.

I would bet that the WikiHelp group in 6 months would accumulate a great
deal of user input simply because of the ease of it's use.

It sounds like what you are implying is that there is a sort of heavy
monitoring of the ability to edit doc pages, and that the goal is to keep
every Tom, Dick, and Harry from doing updates. If that is the case, I
simply have a totally philsophically different approach to how to get your
user community to maintain and participate in documentation.

So at this point I am trying to determine if it is a matter of I am
missing how to become a documenter, becoming on, and then pointing out how
you folks can change the drupal doc pages so that others that follow can
change drupal doc pages simply by clicking one link... or... if Drupal
purposely does not want every Tom dick and harry changing the docs... In
which case you folks have to decide if you want to allow me to make make
the http://groups.drupal.org/WikiHelp group, and see if i can prove that
the fully open system will give you better docs in the long run... or if I
should just forget about documentation, and go back to just being a Drupal
user instead of trying to get involved with helping with Docs.

Cheers! Ricco
Post by Steve Dondley
"Click here to help improve this document," or something to that
effect, with a link to the appropriate page on how to contribute to
documentation would be nice.
I don't know what the thinking is behind the application for document
contributors is. Perhaps the hurdle is there to improve the signal to
noise ratio?
One thing drupal's wiki feature lack is the ability to send out email
notifications when a page is updated. I think this is a crucial
feature that's needed before opening up documentation to every Tom,
Dick, and Harry who wants to change a page. That feature should
probably implemented before documentation became more open. This would
make catching bad edits more timely.
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Marjorie Roswell
2008-04-02 10:55:53 UTC
Permalink
Chiming in for support for Ricco's initiative! Not a replacement, but an
addition sounds great.

Let not this tremendous energy go untapped!

Best,

Margie
Post by r***@webulite.com
Steve,
What you seem to be saying is that I am not missing something. That I
cannot simply sign up to get a "EDIT PAGE" tab at the top of all doc
pages. Assuming you are familiar with how the doc system works more than
me, and your comment was inspired by my post.
If you go to http://groups.drupal.org/WikiHelp, and follow any link to any
page off the front, you will see they are wiki pages, and anyone then just
clicks EDIT, and edits the page (would be cool if groups.drupal.org wiki
pages had the TALK tab implemented and the wiki page content type had a
default to "enable comments read/write, but that is a future feature, not
one currently implemented in the groups.drupal.org world.) And yes,
mediawiki calls what you are talking about a WATCH LIST, and you can sign
up to monitor pages changes. And of course certain mediawiki gods can see
revisions and undo bad edits.
But you see how easy http://groups.drupal.org/WikiHelp pages are to edit?
That was why I set the group up. I don't see what is unDrupal about it...
in fact it seems to be simply a group like the 260 other groups, that
allows members to create wiki pages like the other groups offer. It seems
kind of odd that the moderators would allow a "spain drupal users group"
or many of the other 260+ groups, but not tolerate a "WikiHelp" group. Not
sure how it can hurt things, and it seems like it would be an
experimentation environment that would help shed light on if the drupal
doc group is not getting members because it is too hard to work, or if
simply nobody care about documentation.
I would bet that the WikiHelp group in 6 months would accumulate a great
deal of user input simply because of the ease of it's use.
It sounds like what you are implying is that there is a sort of heavy
monitoring of the ability to edit doc pages, and that the goal is to keep
every Tom, Dick, and Harry from doing updates. If that is the case, I
simply have a totally philsophically different approach to how to get your
user community to maintain and participate in documentation.
So at this point I am trying to determine if it is a matter of I am
missing how to become a documenter, becoming on, and then pointing out how
you folks can change the drupal doc pages so that others that follow can
change drupal doc pages simply by clicking one link... or... if Drupal
purposely does not want every Tom dick and harry changing the docs... In
which case you folks have to decide if you want to allow me to make make
the http://groups.drupal.org/WikiHelp group, and see if i can prove that
the fully open system will give you better docs in the long run... or if I
should just forget about documentation, and go back to just being a Drupal
user instead of trying to get involved with helping with Docs.
Cheers! Ricco
Post by Steve Dondley
"Click here to help improve this document," or something to that
effect, with a link to the appropriate page on how to contribute to
documentation would be nice.
I don't know what the thinking is behind the application for document
contributors is. Perhaps the hurdle is there to improve the signal to
noise ratio?
One thing drupal's wiki feature lack is the ability to send out email
notifications when a page is updated. I think this is a crucial
feature that's needed before opening up documentation to every Tom,
Dick, and Harry who wants to change a page. That feature should
probably implemented before documentation became more open. This would
make catching bad edits more timely.
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Addison Berry
2008-04-02 12:57:40 UTC
Permalink
I've not got time to digest and respond to the whole thread right now,
but just wanted to point out the instructions for joining docs are here:
http://drupal.org/node/23367, first page under the Contributing to
docs section.
Post by r***@webulite.com
Steve,
What you seem to be saying is that I am not missing something. That I
cannot simply sign up to get a "EDIT PAGE" tab at the top of all doc
pages. Assuming you are familiar with how the doc system works more than
me, and your comment was inspired by my post.
If you go to http://groups.drupal.org/WikiHelp, and follow any link to any
page off the front, you will see they are wiki pages, and anyone then just
clicks EDIT, and edits the page (would be cool if groups.drupal.org wiki
pages had the TALK tab implemented and the wiki page content type had a
default to "enable comments read/write, but that is a future
feature, not
one currently implemented in the groups.drupal.org world.) And yes,
mediawiki calls what you are talking about a WATCH LIST, and you can sign
up to monitor pages changes. And of course certain mediawiki gods can see
revisions and undo bad edits.
But you see how easy http://groups.drupal.org/WikiHelp pages are to edit?
That was why I set the group up. I don't see what is unDrupal about it...
in fact it seems to be simply a group like the 260 other groups, that
allows members to create wiki pages like the other groups offer. It seems
kind of odd that the moderators would allow a "spain drupal users group"
or many of the other 260+ groups, but not tolerate a "WikiHelp" group. Not
sure how it can hurt things, and it seems like it would be an
experimentation environment that would help shed light on if the drupal
doc group is not getting members because it is too hard to work, or if
simply nobody care about documentation.
I would bet that the WikiHelp group in 6 months would accumulate a great
deal of user input simply because of the ease of it's use.
It sounds like what you are implying is that there is a sort of heavy
monitoring of the ability to edit doc pages, and that the goal is to keep
every Tom, Dick, and Harry from doing updates. If that is the case, I
simply have a totally philsophically different approach to how to get your
user community to maintain and participate in documentation.
So at this point I am trying to determine if it is a matter of I am
missing how to become a documenter, becoming on, and then pointing out how
you folks can change the drupal doc pages so that others that follow can
change drupal doc pages simply by clicking one link... or... if Drupal
purposely does not want every Tom dick and harry changing the
docs... In
which case you folks have to decide if you want to allow me to make make
the http://groups.drupal.org/WikiHelp group, and see if i can prove that
the fully open system will give you better docs in the long run... or if I
should just forget about documentation, and go back to just being a Drupal
user instead of trying to get involved with helping with Docs.
Cheers! Ricco
Post by Steve Dondley
"Click here to help improve this document," or something to that
effect, with a link to the appropriate page on how to contribute to
documentation would be nice.
I don't know what the thinking is behind the application for document
contributors is. Perhaps the hurdle is there to improve the signal to
noise ratio?
One thing drupal's wiki feature lack is the ability to send out email
notifications when a page is updated. I think this is a crucial
feature that's needed before opening up documentation to every Tom,
Dick, and Harry who wants to change a page. That feature should
probably implemented before documentation became more open. This would
make catching bad edits more timely.
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Steven Peck
2008-04-02 17:56:37 UTC
Permalink
Also not time to respond in detail but I would like to point out
something. On the /handbook page. The first paragraph. Please read
it. Please.

There are several links in it but the last sentence on the first
paragraph. If you are interested in editing existing content then
sign up to help. That links to a page with the various ways to
contribute. It also has a paragraph with another link. "Join the
documentation team" with detailed instructions. While not as direct,
if you look at the revisions tab, we have had a similar link for more
then a year (which is when I enabled revisions on that page).

I am not really sure how much more obvious I can make it. Adding
stuff to every page is a suggestion but we are also competing with a
lot of other information on each page.

Steven
Post by Addison Berry
I've not got time to digest and respond to the whole thread right now,
http://drupal.org/node/23367, first page under the Contributing to
docs section.
Post by r***@webulite.com
Steve,
What you seem to be saying is that I am not missing something. That I
cannot simply sign up to get a "EDIT PAGE" tab at the top of all doc
pages. Assuming you are familiar with how the doc system works more than
me, and your comment was inspired by my post.
If you go to http://groups.drupal.org/WikiHelp, and follow any link to any
page off the front, you will see they are wiki pages, and anyone then just
clicks EDIT, and edits the page (would be cool if groups.drupal.org wiki
pages had the TALK tab implemented and the wiki page content type had a
default to "enable comments read/write, but that is a future feature, not
one currently implemented in the groups.drupal.org world.) And yes,
mediawiki calls what you are talking about a WATCH LIST, and you can sign
up to monitor pages changes. And of course certain mediawiki gods can see
revisions and undo bad edits.
But you see how easy http://groups.drupal.org/WikiHelp pages are to edit?
That was why I set the group up. I don't see what is unDrupal about it...
in fact it seems to be simply a group like the 260 other groups, that
allows members to create wiki pages like the other groups offer. It seems
kind of odd that the moderators would allow a "spain drupal users group"
or many of the other 260+ groups, but not tolerate a "WikiHelp" group. Not
sure how it can hurt things, and it seems like it would be an
experimentation environment that would help shed light on if the drupal
doc group is not getting members because it is too hard to work, or if
simply nobody care about documentation.
I would bet that the WikiHelp group in 6 months would accumulate a great
deal of user input simply because of the ease of it's use.
It sounds like what you are implying is that there is a sort of heavy
monitoring of the ability to edit doc pages, and that the goal is to keep
every Tom, Dick, and Harry from doing updates. If that is the case, I
simply have a totally philsophically different approach to how to get your
user community to maintain and participate in documentation.
So at this point I am trying to determine if it is a matter of I am
missing how to become a documenter, becoming on, and then pointing out how
you folks can change the drupal doc pages so that others that follow can
change drupal doc pages simply by clicking one link... or... if Drupal
purposely does not want every Tom dick and harry changing the docs... In
which case you folks have to decide if you want to allow me to make make
the http://groups.drupal.org/WikiHelp group, and see if i can prove that
the fully open system will give you better docs in the long run... or if I
should just forget about documentation, and go back to just being a Drupal
user instead of trying to get involved with helping with Docs.
Cheers! Ricco
Post by Steve Dondley
"Click here to help improve this document," or something to that
effect, with a link to the appropriate page on how to contribute to
documentation would be nice.
I don't know what the thinking is behind the application for document
contributors is. Perhaps the hurdle is there to improve the signal to
noise ratio?
One thing drupal's wiki feature lack is the ability to send out email
notifications when a page is updated. I think this is a crucial
feature that's needed before opening up documentation to every Tom,
Dick, and Harry who wants to change a page. That feature should
probably implemented before documentation became more open. This would
make catching bad edits more timely.
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Steven Peck
2008-04-02 18:04:25 UTC
Permalink
We want anyone who has actually expressed an interest in doing so to
be able to change content. All you have to do is express an interest.
That's it. I have found that those people are more willing to
actually do things.

Larry wrote up a blog post before I could that essentially sums up
some other considerations and folks should take a look at it. I
pretty much agree with it which is good as I have the responsibility
of making the decision.

http://www.garfieldtech.com/drupal-org-wiki

Steven
Post by Steven Peck
Also not time to respond in detail but I would like to point out
something. On the /handbook page. The first paragraph. Please read
it. Please.
There are several links in it but the last sentence on the first
paragraph. If you are interested in editing existing content then
sign up to help. That links to a page with the various ways to
contribute. It also has a paragraph with another link. "Join the
documentation team" with detailed instructions. While not as direct,
if you look at the revisions tab, we have had a similar link for more
then a year (which is when I enabled revisions on that page).
I am not really sure how much more obvious I can make it. Adding
stuff to every page is a suggestion but we are also competing with a
lot of other information on each page.
Steven
Post by Addison Berry
I've not got time to digest and respond to the whole thread right now,
http://drupal.org/node/23367, first page under the Contributing to
docs section.
Post by r***@webulite.com
Steve,
What you seem to be saying is that I am not missing something. That I
cannot simply sign up to get a "EDIT PAGE" tab at the top of all doc
pages. Assuming you are familiar with how the doc system works more than
me, and your comment was inspired by my post.
If you go to http://groups.drupal.org/WikiHelp, and follow any link to any
page off the front, you will see they are wiki pages, and anyone then just
clicks EDIT, and edits the page (would be cool if groups.drupal.org wiki
pages had the TALK tab implemented and the wiki page content type had a
default to "enable comments read/write, but that is a future feature, not
one currently implemented in the groups.drupal.org world.) And yes,
mediawiki calls what you are talking about a WATCH LIST, and you can sign
up to monitor pages changes. And of course certain mediawiki gods can see
revisions and undo bad edits.
But you see how easy http://groups.drupal.org/WikiHelp pages are to edit?
That was why I set the group up. I don't see what is unDrupal about it...
in fact it seems to be simply a group like the 260 other groups, that
allows members to create wiki pages like the other groups offer. It seems
kind of odd that the moderators would allow a "spain drupal users group"
or many of the other 260+ groups, but not tolerate a "WikiHelp" group. Not
sure how it can hurt things, and it seems like it would be an
experimentation environment that would help shed light on if the drupal
doc group is not getting members because it is too hard to work, or if
simply nobody care about documentation.
I would bet that the WikiHelp group in 6 months would accumulate a great
deal of user input simply because of the ease of it's use.
It sounds like what you are implying is that there is a sort of heavy
monitoring of the ability to edit doc pages, and that the goal is to keep
every Tom, Dick, and Harry from doing updates. If that is the case, I
simply have a totally philsophically different approach to how to get your
user community to maintain and participate in documentation.
So at this point I am trying to determine if it is a matter of I am
missing how to become a documenter, becoming on, and then pointing out how
you folks can change the drupal doc pages so that others that follow can
change drupal doc pages simply by clicking one link... or... if Drupal
purposely does not want every Tom dick and harry changing the docs... In
which case you folks have to decide if you want to allow me to make make
the http://groups.drupal.org/WikiHelp group, and see if i can prove that
the fully open system will give you better docs in the long run... or if I
should just forget about documentation, and go back to just being a Drupal
user instead of trying to get involved with helping with Docs.
Cheers! Ricco
Post by Steve Dondley
"Click here to help improve this document," or something to that
effect, with a link to the appropriate page on how to contribute to
documentation would be nice.
I don't know what the thinking is behind the application for document
contributors is. Perhaps the hurdle is there to improve the signal to
noise ratio?
One thing drupal's wiki feature lack is the ability to send out email
notifications when a page is updated. I think this is a crucial
feature that's needed before opening up documentation to every Tom,
Dick, and Harry who wants to change a page. That feature should
probably implemented before documentation became more open. This would
make catching bad edits more timely.
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/

Addison Berry
2008-04-02 13:05:14 UTC
Permalink
Post by Steve Dondley
"Click here to help improve this document," or something to that
effect, with a link to the appropriate page on how to contribute to
documentation would be nice.
We currently have a "Suggest documentation improvements" link on every
page in the Quick Links block. I agree that making it clearer/more
prominent would be nice and this should be addressed in the redesign.
People also seem to miss the "Add child page" link under every single
page too (that *everyone* with a d.o account has - not just docs team)
so I'd like that more prominent too. Definitely will happen in the
redesign.
Post by Steve Dondley
I don't know what the thinking is behind the application for document
contributors is. Perhaps the hurdle is there to improve the signal to
noise ratio?
Pretty much yes. Adding new pages *is* open to everyone on d.o. The
application to edit and move happened after a period in the past where
those rights were open to everyone as well and the mess was too much
to keep cleaned up by the few people actually working on it.
Post by Steve Dondley
One thing drupal's wiki feature lack is the ability to send out email
notifications when a page is updated. I think this is a crucial
feature that's needed before opening up documentation to every Tom,
Dick, and Harry who wants to change a page. That feature should
probably implemented before documentation became more open. This would
make catching bad edits more timely.
Post by r***@webulite.com
Hi Shai,
I would not call myself a programmer or a developer. I know some php, and
I maintain my Drupal install, and have done some mode... but I am talking
about (B) improving the usability of the drupal documentation. Since I am
a believer and user of the wiki asepcts of Drupal, I choose "Wiki" +
"Help" as the group, I would create. To imply "Help" with the "wiki"
stuff. But, I would be happy to help with documentation of more that wiki
functionality, if the Drupal system would install a wiki, for all their
documentation.
Thanks for telling me that you can EDIT a wiki handbook if you join the
wiki documentation project. That for example is a pretty amazing
revelation. And you would think that instructions to do that would be on
the very first documentation page off the documentation tab.
... but I just went to http://drupal.org/project/documentation per your
suggestion, and I am logged in, and there is no link to join. I did start
following a few links, and headed to here; http://drupal.org/node/23367
and even there it does not indicate how to become a person that get's an
edit tab of doc pages. There is lots of talk about guidelines and how to
"submit an issues", etc... as you say it is a bit "tricky".
The point being, it certianly is not easy... and perhaps that is why there
are only 240+ people on the doc team. Now on mediawiki.org my
mother can
figure out how to add a sentence to any page in about 3 minutes. Why can
Drupal wiki's documentation be THAT easy? the more eyes and hands updating
the pages, they better documentation it will become. And it needs to be
Easy and Obvious for even the beginner to do it.
This page; http://drupal.org/project/issues/documentation/ seems the
closest thing I have found to adding to the documentation. and then this;
http://drupal.org/node/240536 which seems to be a form that allows me to
request to join the doc team, but look at the extra pull downs and check
boxes I need to add. i have to decide what part of the team I want to
join, and what functionality I want to add to... god it just seems so damn
complex, certainly not inviting. Does this mean if I pick the wrong
component type that I will not be able to edit other component pages, how
can I pick ALL?
As you can see I am crying out for either direction to the hidden way of
viewing things differently than i have been to see what you see... or
trying to point out, that the documentation system is too complex to be
inviting to get people to join.
Second... do the documentation pages allow FREELINKING, ie [[happy page]]
? I got the impression that this was not supported in the
documentation.
I would be happy to join the #drupal-support or some other channel if
someone can walk me though understanding this.
Cheers! Ricco
Post by Shai Gluskin
Hi Ricco,
I'm still confused after reading your e-mail which of the
following is
your
a. making Drupal, the software, a really great platform for wiki
implementations
or
b. improving wiki functionality for the documentation sections at Drupal.org
.
Though you can argue that a and b are certainly related, I think it would
help folks to understand which of the two is your first interest
in order
to
figure out the best way for you to get involved.
As an FYI, in order to see the "edit" tab on documentation pages at
drupal.org, one need only join the documentation team, by
submitting a
request at http://drupal.org/project/documentation.
It can be a little tricky figuring out exactly how and where to help in
Drupal, especially at the beginning. But I really hope you figure
it out.
I
myself am very much interested in developing wiki functionality on a couple
of sites right now and I too think that Drupal can be way more
powerful
with
easier UI than Mediawiki.
All the best,
Shai
content2zero <http://content2zero.com>
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Prometheus Labor Communications, Inc.
http://prometheuslabor.com
413-572-1300
Communicate or Die: American Labor Unions and the Internet
http://communicateordie.com
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/
Loading...