Debian Bug report logs - #608400
re-organize how to contribute documentation "per-profile"

Package: www.debian.org; Maintainer for www.debian.org is Debian WWW Team <debian-www@lists.debian.org>;

Reported by: Stefano Zacchiroli <zack@debian.org>

Date: Thu, 30 Dec 2010 15:15:05 UTC

Severity: normal

Tags: confirmed

Merged with 742266

Reply or subscribe to this bug.

Toggle useless messages

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to debian-bugs-dist@lists.debian.org, Debian WWW Team <debian-www@lists.debian.org>:
Bug#608400; Package www.debian.org. (Thu, 30 Dec 2010 15:15:08 GMT) Full text and rfc822 format available.

Acknowledgement sent to Stefano Zacchiroli <zack@debian.org>:
New Bug report received and forwarded. Copy sent to Debian WWW Team <debian-www@lists.debian.org>. (Thu, 30 Dec 2010 15:15:08 GMT) Full text and rfc822 format available.

Message #5 received at submit@bugs.debian.org (full text, mbox):

From: Stefano Zacchiroli <zack@debian.org>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: re-organize how to contribute documentation "per-profile"
Date: Thu, 30 Dec 2010 16:13:23 +0100
Package: www.debian.org
Severity: normal

Out of curiosity in response to various DPL inquiries about "how can I help
Debian?", I've reviewed a bit the various pieces of documentation on the
subject and compared it with what other distros do.  A remarkable difference
seems to be a "per-profile" organization of the available material,
i.e. organizing the "how to contribute" page with a top-level distinction
among, say: developers, translators, bug triager, artists, donors, etc.

I believe there is some value in such a distinction, simply because the users
interested into helping out usually knows pretty well what they are able and
willing to do.  I hence suggest to reorganize the content of
http://www.debian.org/intro/help according to the various profiles.

Just for reference, here a few links to what others (random sampling, not
necessarily representative) have been doing in that respect:

- Fedora: http://fedoraproject.org/en/join-fedora (scrolling a bit down)
- Ubuntu: http://www.ubuntu.com/community
- OpenSUSE: http://en.opensuse.org/Portal:How_to_participate

Thanks a lot for maintaining www.d.o,
Cheers.

-- System Information:
Debian Release: 6.0
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=it_IT.utf8, LC_CTYPE=it_IT.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash




Added tag(s) confirmed. Request was from madamezou@yahoo.it to control@bugs.debian.org. (Thu, 30 Dec 2010 15:45:02 GMT) Full text and rfc822 format available.

Information forwarded to debian-bugs-dist@lists.debian.org, Debian WWW Team <debian-www@lists.debian.org>:
Bug#608400; Package www.debian.org. (Fri, 04 Feb 2011 09:36:06 GMT) Full text and rfc822 format available.

Acknowledgement sent to Stefano Zacchiroli <zack@debian.org>:
Extra info received and forwarded to list. Copy sent to Debian WWW Team <debian-www@lists.debian.org>. (Fri, 04 Feb 2011 09:36:07 GMT) Full text and rfc822 format available.

Message #12 received at 608400@bugs.debian.org (full text, mbox):

From: Stefano Zacchiroli <zack@debian.org>
To: 608400@bugs.debian.org
Cc: Julien Viard de Galbert <julien@vdg.blogsite.org>
Subject: pointers to form a "bug triager" profile documentation
Date: Fri, 4 Feb 2011 10:33:38 +0100
[Message part 1 (text/plain, inline)]
On Thu, Dec 30, 2010 at 04:13:23PM +0100, Stefano Zacchiroli wrote:
> among, say: developers, translators, bug triager, artists, donors, etc.

Please find attached a draft which could form the basis for documenting
a bug triager profile, which we currently lack.  The draft as been
kindly provided by Julien Viard de Galbert (the mighty X strike force
bug triager!) upon my request, thanks!

It remains to be seen whether it's worth to splice in the wiki page into
the www.d.o or not, ... but it's a start!

Cheers.

-- 
Stefano Zacchiroli -o- PhD in Computer Science \ PostDoc @ Univ. Paris 7
zack@{upsilon.cc,pps.jussieu.fr,debian.org} -<>- http://upsilon.cc/zack/
Quando anche i santi ti voltano le spalle, |  .  |. I've fans everywhere
ti resta John Fante -- V. Capossela .......| ..: |.......... -- C. Adams
[triaging_contribution.txt (text/plain, attachment)]
[signature.asc (application/pgp-signature, inline)]

Information forwarded to debian-bugs-dist@lists.debian.org, Debian WWW Team <debian-www@lists.debian.org>:
Bug#608400; Package www.debian.org. (Sat, 14 May 2011 21:03:03 GMT) Full text and rfc822 format available.

Acknowledgement sent to Alexander Reshetov <eof@debian-by.org>:
Extra info received and forwarded to list. Copy sent to Debian WWW Team <debian-www@lists.debian.org>. (Sat, 14 May 2011 21:03:03 GMT) Full text and rfc822 format available.

Message #17 received at 608400@bugs.debian.org (full text, mbox):

From: Alexander Reshetov <eof@debian-by.org>
To: 608400@bugs.debian.org, debian-www@lists.debian.org
Subject: Re: re-organize how to contribute documentation "per-profile"
Date: Sun, 15 May 2011 00:00:29 +0300
[Message part 1 (text/plain, inline)]
Stefano Zacchiroli wrote:
> Out of curiosity in response to various DPL inquiries about "how can I help
> Debian?", I've reviewed a bit the various pieces of documentation on the
> subject and compared it with what other distros do.  A remarkable difference
> seems to be a "per-profile" organization of the available material,
> i.e. organizing the "how to contribute" page with a top-level distinction
> among, say: developers, translators, bug triager, artists, donors, etc.
> 
> I believe there is some value in such a distinction, simply because the users
> interested into helping out usually knows pretty well what they are able and
> willing to do.  I hence suggest to reorganize the content of
> http://www.debian.org/intro/help according to the various profiles.
> 
> Just for reference, here a few links to what others (random sampling, not
> necessarily representative) have been doing in that respect:
> 
> - Fedora: http://fedoraproject.org/en/join-fedora (scrolling a bit down)
> - Ubuntu: http://www.ubuntu.com/community
> - OpenSUSE: http://en.opensuse.org/Portal:How_to_participate

Good idea.
I just found at wiki.d.o page "Debian for non coder contributors" [1].
I think it can be a good start point. We can start from this wiki page and
when it will be more or less finished it can be copied to www.d.o.

 1 : http://wiki.debian.org/DebianForNonCoderContributors
[signature.asc (application/pgp-signature, inline)]

Message sent on to Stefano Zacchiroli <zack@debian.org>:
Bug#608400. (Sat, 14 May 2011 21:57:03 GMT) Full text and rfc822 format available.

Message #20 received at 608400-submitter@bugs.debian.org (full text, mbox):

From: Francesca Ciceri <madamezou@yahoo.it>
To: Alexander Reshetov <eof@debian-by.org>
Cc: 608400-submitter@bugs.debian.org
Subject: Re: re-organize how to contribute documentation "per-profile"
Date: Sat, 14 May 2011 23:52:01 +0200
[Message part 1 (text/plain, inline)]
On Sun, May 15, 2011 at 12:00:29AM +0300, Alexander Reshetov wrote:
> Stefano Zacchiroli wrote:
> > Out of curiosity in response to various DPL inquiries about "how can I help
> > Debian?", I've reviewed a bit the various pieces of documentation on the
> > subject and compared it with what other distros do.  A remarkable difference
> > seems to be a "per-profile" organization of the available material,
> > i.e. organizing the "how to contribute" page with a top-level distinction
> > among, say: developers, translators, bug triager, artists, donors, etc.
> > 
> > I believe there is some value in such a distinction, simply because the users
> > interested into helping out usually knows pretty well what they are able and
> > willing to do.  I hence suggest to reorganize the content of
> > http://www.debian.org/intro/help according to the various profiles.
> > 
> > Just for reference, here a few links to what others (random sampling, not
> > necessarily representative) have been doing in that respect:
> > 
> > - Fedora: http://fedoraproject.org/en/join-fedora (scrolling a bit down)
> > - Ubuntu: http://www.ubuntu.com/community
> > - OpenSUSE: http://en.opensuse.org/Portal:How_to_participate
> 
> Good idea.
> I just found at wiki.d.o page "Debian for non coder contributors" [1].
> I think it can be a good start point. We can start from this wiki page and
> when it will be more or less finished it can be copied to www.d.o.
> 
>  1 : http://wiki.debian.org/DebianForNonCoderContributors

Yes, the wiki has some interesting pages about that.
I've tried to create a first scheme of the profile, based both on the
links provided by zack and on the page you've linked: below the result.

Note that this is a draft: I've put in it some links but it's not at all
exhaustive :).

Cheers, 
Francesca

8<-----

## Links and subcategories for profiles

Developers:
 	* packaging
    		* packaging new applications (see WNPP)
    		* help teams → http://wiki.debian.org/Teams
    		* ports → http://www.debian.org/ports/
    		* help with already existent packages (see WNPP)
	* Bugs
		* RC bugs http://bugs.debian.org/release-critical/
		* Bug triaging http://wiki.debian.org/BugTriage
		* QA → http://qa.debian.org/

Non developers:
	* Artists:
		* Design new themes http://wiki.debian.org/DebianArt 
   		* help in the maintainence of the fonts (or design new fonts) http://wiki.debian.org/FontsTaskForce
    	* Translators:
       		* translate website, documentation, po-debconf, DPN:
		* http://lists.debian.org/i18n.html, http://www.debian.org/international/
        * Doc writers:
	   	* write manuals/howto/FAQ http://www.debian.org/doc/ddp
	      	* help the doc team http://www.debian.org/doc/todo
	        * write manpages http://lintian.debian.org/tags/binary-without-manpage.html
	* Publicity:
	        * help in writing/reviewing news and DPN: http://lists.debian.org/debian-publicity/
	* Events: http://wiki.debian.org/Promote

Support:
	* Help users on ML, IRC, forums

Sponsors:
	* donate money
	* donate hardware

8<----------
-- 
<taffit> eof: when I want something | "Convince people with results,
done quickly, I don't wait for      |  rather than words"
others ;)			    |  Enrico Zini
				

[signature.asc (application/pgp-signature, inline)]

Information stored :
Bug#608400; Package www.debian.org. (Tue, 17 May 2011 11:45:26 GMT) Full text and rfc822 format available.

Acknowledgement sent to Stefano Zacchiroli <leader@debian.org>:
Extra info received and filed, but not forwarded. (Tue, 17 May 2011 11:45:29 GMT) Full text and rfc822 format available.

Message #25 received at 608400-quiet@bugs.debian.org (full text, mbox):

From: Stefano Zacchiroli <leader@debian.org>
To: Francesca Ciceri <madamezou@yahoo.it>, 608400-quiet@bugs.debian.org
Cc: Alexander Reshetov <eof@debian-by.org>
Subject: Re: Bug#608400: re-organize how to contribute documentation "per-profile"
Date: Tue, 17 May 2011 13:43:44 +0200
[Message part 1 (text/plain, inline)]
On Sat, May 14, 2011 at 11:52:01PM +0200, Francesca Ciceri wrote:
> > I just found at wiki.d.o page "Debian for non coder contributors" [1].
> > I think it can be a good start point. We can start from this wiki page and
> > when it will be more or less finished it can be copied to www.d.o.
> > 
> >  1 : http://wiki.debian.org/DebianForNonCoderContributors
> 
> Yes, the wiki has some interesting pages about that.
> I've tried to create a first scheme of the profile, based both on the
> links provided by zack and on the page you've linked: below the result.

Thanks to both of you for the work thus far, it looks very good to me.

I just have a few extra comments, which are reported below.

> ## Links and subcategories for profiles

How about adding a category "Users" before developers with a single
entry "report bug" pointing to some bug reporting tutorial, or even
simply to the instruction on how to report a bug which we do have on the
BTS? Reporting bug is a fundamental contribution that users can, and
should, make. Mentioning it in an "how to contribute" page might help in
feeling users more useful and, in general, is the first step for getting
more engaged later on.

> Developers:
>  	* packaging
>     		* packaging new applications (see WNPP)
>     		* help teams → http://wiki.debian.org/Teams
>     		* ports → http://www.debian.org/ports/
>     		* help with already existent packages (see WNPP)

ACK on the above. We might want to refine a bit the 1st and 4th point
with more specific links. I guess you already had that in mind, but
let's see if we agree. "packaging new applications" should link to RFPs
(and ITPs for review?). "help with existing packages" should link to
RFH, RFA, O bugs and --- outside WNPP --- bugs tagged "+help".

> 	* Bugs
> 		* RC bugs http://bugs.debian.org/release-critical/
> 		* Bug triaging http://wiki.debian.org/BugTriage
> 		* QA → http://qa.debian.org/

Add something about Bug Squashing Parties here?  There is a wiki page
about it (http://wiki.debian.org/BSP), which is in need on some love
though (I've worked a bit on it in the past, but there is still too much
redundancy among marathons / planning / etc. I've also created the
http://wiki.debian.org/CategoryBsp category for it and maintained it for
a while, but for some reasons categories seem to be a bit brittle on
wiki.d.o).

> Non developers:
> 	* Artists:
> 		* Design new themes http://wiki.debian.org/DebianArt 
>    		* help in the maintainence of the fonts (or design new fonts) http://wiki.debian.org/FontsTaskForce
>     	* Translators:
>        		* translate website, documentation, po-debconf, DPN:
> 		* http://lists.debian.org/i18n.html, http://www.debian.org/international/
>         * Doc writers:
> 	   	* write manuals/howto/FAQ http://www.debian.org/doc/ddp
> 	      	* help the doc team http://www.debian.org/doc/todo
> 	        * write manpages http://lintian.debian.org/tags/binary-without-manpage.html
> 	* Publicity:
> 	        * help in writing/reviewing news and DPN: http://lists.debian.org/debian-publicity/

Here there is clearly a tension among having a detailed list on the
www.d.o website and delegating more specific tasks to other pages. For
instance should we mention here DPN or rather point to
http://wiki.debian.org/Teams/Publicity which does have a "get involved"
section already mentioning DPN? In this specific case, I agree with you
that DPN should be mention upfront, as it's an official news media of
the Debian Project, but in general it's a tension to be considered.

Also, I suggest to point to http://wiki.debian.org/Teams/Publicity
instead of pointing to the mailing list address.

> 	* Events: http://wiki.debian.org/Promote

This is very good, as we often lack people to attend booth, speak on
behalf of Debian at events, or the like. Unfortunately, it doesn't seem
to me that the above wiki page helps in knowing when/where Debian need
booth staff, but I've no better target link to suggest either.
Francesca, with your events team hat on, do you have any idea about
where we can point people to be informed about when/where Debian needs
booth help?

> Support:
> 	* Help users on ML, IRC, forums

ACK, some links I'd like to mention here are: ask.d.n, irc.d.o,
forums.d.n, and the lists. All in all, it's material which is already
mentioned at http://www.debian.org/support , so it might be sensible to
point to that page all together. Again, this is the usual tension among
duplicating info in this page and referencing an external one.

Maybe, a way to solve it is to factorize the relevant snippets using WML
includes. I've no idea whether you already have in the -www team best
practices for this kind of stuff.

> Sponsors:
> 	* donate money
> 	* donate hardware

I suggest to add here "become a partner", pointing to
http://www.debian.org/partners/partners

Thanks a lot!
Cheers.
-- 
Stefano Zacchiroli -o- PhD in Computer Science \ PostDoc @ Univ. Paris 7
zack@{upsilon.cc,pps.jussieu.fr,debian.org} -<>- http://upsilon.cc/zack/
Quando anche i santi ti voltano le spalle, |  .  |. I've fans everywhere
ti resta John Fante -- V. Capossela .......| ..: |.......... -- C. Adams
[signature.asc (application/pgp-signature, inline)]

Information forwarded to debian-bugs-dist@lists.debian.org, Debian WWW Team <debian-www@lists.debian.org>:
Bug#608400; Package www.debian.org. (Sat, 24 Aug 2013 03:21:05 GMT) Full text and rfc822 format available.

Acknowledgement sent to Sean m <sean.m456@gmail.com>:
Extra info received and forwarded to list. Copy sent to Debian WWW Team <debian-www@lists.debian.org>. (Sat, 24 Aug 2013 03:21:05 GMT) Full text and rfc822 format available.

Message #30 received at 608400@bugs.debian.org (full text, mbox):

From: Sean m <sean.m456@gmail.com>
To: 608400@bugs.debian.org
Subject: re-organize how to contribute documentation "per-profile"
Date: Fri, 23 Aug 2013 20:18:46 -0700
[Message part 1 (text/plain, inline)]
Hey guys,

I'm ready to take on this task. I'll work on it and get back to you!
Thanks

-- 

Sean Mottles
[Message part 2 (text/html, inline)]

Information forwarded to debian-bugs-dist@lists.debian.org, Debian WWW Team <debian-www@lists.debian.org>:
Bug#608400; Package www.debian.org. (Mon, 26 Aug 2013 06:21:04 GMT) Full text and rfc822 format available.

Acknowledgement sent to Sean m <sean.m456@gmail.com>:
Extra info received and forwarded to list. Copy sent to Debian WWW Team <debian-www@lists.debian.org>. (Mon, 26 Aug 2013 06:21:04 GMT) Full text and rfc822 format available.

Message #35 received at 608400@bugs.debian.org (full text, mbox):

From: Sean m <sean.m456@gmail.com>
To: 608400@bugs.debian.org
Cc: moray@sermisy.org, madamezou@yahoo.it
Subject: "Helping Debian" First Draft
Date: Sun, 25 Aug 2013 23:17:01 -0700
[Message part 1 (text/plain, inline)]
Hey everyone,

Here's what I came up with for the first draft of the new page. If there's
anything that you want added just let me know, or feel free to add it! For
the introduction I took parts of other pages that I thought would be
relevant to the information given here.

 I have added two small notes, one at the end of the intro paragraph and
one under "Publicity/Events". If someone could take a look at those that
would be great! (:

I'm also unsure of how the formatting should be done, I was just following
Francesca's example on the report. That's something I could work on for
version 2!

Thanks!

-- 

Sean Mottles
[Message part 2 (text/html, inline)]
[HelpingDebian.txt (text/plain, attachment)]

Information forwarded to debian-bugs-dist@lists.debian.org, Debian WWW Team <debian-www@lists.debian.org>:
Bug#608400; Package www.debian.org. (Fri, 03 Jan 2014 07:36:19 GMT) Full text and rfc822 format available.

Acknowledgement sent to sean <sean.m456@gmail.com>:
Extra info received and forwarded to list. Copy sent to Debian WWW Team <debian-www@lists.debian.org>. (Fri, 03 Jan 2014 07:36:19 GMT) Full text and rfc822 format available.

Message #40 received at 608400@bugs.debian.org (full text, mbox):

From: sean <sean.m456@gmail.com>
To: 608400@bugs.debian.org
Cc: zack@debian.org, madamezou@yahoo.it, moray@sermisy.org
Subject: re-organize how to contribute documentation "per-profile"
Date: Thu, 02 Jan 2014 23:27:53 -0800
[Message part 1 (text/plain, inline)]
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Here's a formatted version, in wml, of my draft for the new Intro/Help
page.

I've incorporated many of the items on the original page into my
revision, while keeping the structure that was mentioned earlier in
the bug report.

Feel free to give me suggestions on what to improve!


Thanks,

Sean
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBAgAGBQJSxmZ5AAoJEC9ACRPRNMOU/aEH/2/QW3e3+Lnk6UcFHLDgqnrW
ELf8GPWW9fBdg4ysSt8E8tJ8Bdc5tqKMmX23FUdFGqOaoObYpR08gwIdbsKPAAt5
iKkO0nem10V4Fj4bDzRVIR3kIpUkDyXcT1oRwo+LDJvdleDivgEmZU2t+sy3LNO+
VYVgf4Fgh638qmuqvCynW7pbRt45sNoljKg51J9bgjTCHPbbLp2uDLhZ7fgzZjEh
1wwGWVpi+h5sR4/tpkfBu3k/4a5a4X4FSMzUzR4TrUTKyrThsl+WY17LJu03NqI8
xeBffhvH9uM6QTZDsgCkmMG92k4JQsnaI6bA/Twg18Y47LBzZHYmJdfXQJzLhg8=
=Eh6u
-----END PGP SIGNATURE-----
[help.en.html (text/html, attachment)]
[help.wml (text/vnd.wap.wml, attachment)]

Merged 608400 742266 Request was from David Prévot <taffit@debian.org> to control@bugs.debian.org. (Sun, 23 Mar 2014 13:51:10 GMT) Full text and rfc822 format available.

Send a report that this bug log contains spam.


Debian bug tracking system administrator <owner@bugs.debian.org>. Last modified: Thu Apr 17 16:27:35 2014; Machine Name: buxtehude.debian.org

Debian Bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.