Developer Documentation feedback
 

Hi everyone,

I am interested in gathering feedback on the state of our developer
documentation. I just don't want feedback from doc people but from
Ubuntu developers themselves who have been consuming these docs.
Currently the developer link from ubuntu.com points people to this
page: https://wiki.ubuntu.com/UbuntuDevelopment

This page covers an immense amount of information about all aspects of
Ubuntu Development. Mozilla has a "Mozilla Hacking in a Nutshell" page
that caught my eye in a format that looks useful:
http://www.mozilla.org/hacking/

I am wondering if perhaps we should have a more focused set of pages
that makes it easier for people to drill down into a specific area of
development as opposed to "One Big Page" or if we should start looking
at something a bit more structured? I've heard many developer-friends
of mine (who are not involved in Ubuntu) say that they wish Linux had
an equivalent of the documentation that is in something like MSDN
because they can never find anything and get lost in a bunch of wiki
pages.

Mainly, I am interested in getting feedback on how we can knock down a
barrier to entry-level people who might be interested in doing their
first contribution to Ubuntu, the UbuntuDevelopment page feels
intimidating to me. Yes, I realize that there's only so much one can
do in making a complicated task simple and the answer might be
"there's no way to explain this any simpler".

--
Jorge Castro
jorge (at) ubuntu.com
External Project Developer Relations
Canonical Ltd.

--
ubuntu-devel mailing list
ubuntu-devel@lists.ubuntu.com
Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel

Developer Documentation feedback
 

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Jorge O. Castro wrote on 03/03/09 00:00:
>...
> I am interested in gathering feedback on the state of our developer
> documentation. I just don't want feedback from doc people but from
> Ubuntu developers themselves who have been consuming these docs.
> Currently the developer link from ubuntu.com points people to this
> page: https://wiki.ubuntu.com/UbuntuDevelopment
>
> This page covers an immense amount of information about all aspects of
> Ubuntu Development. Mozilla has a "Mozilla Hacking in a Nutshell" page
> that caught my eye in a format that looks useful:
> http://www.mozilla.org/hacking/
>
> I am wondering if perhaps we should have a more focused set of pages
> that makes it easier for people to drill down into a specific area of
> development as opposed to "One Big Page" or if we should start looking
> at something a bit more structured? I've heard many developer-friends
> of mine (who are not involved in Ubuntu) say that they wish Linux had
> an equivalent of the documentation that is in something like MSDN
> because they can never find anything and get lost in a bunch of wiki
> pages.
>...

There's an important distinction here, between developing the platform
and developing for the platform.

mozilla.org/hacking is about developing Mozilla itself.

MSDN is mostly about developing applications *for* Windows etc.

UbuntuDevelopment is about developing Ubuntu itself.

We appear to have no organized information at all for people who want to
develop applications *for* Ubuntu.

Cheers
- --
Matthew Paul Thomas
http://mpt.net.nz/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkmtW04ACgkQ6PUxNfU6ecpxZgCgpNHITvTlhx Nr+NvgFFf+vMGg
5jEAoIw6UGg9Xv0yGbEpD2f5POk2Sdl8
=cjZV
-----END PGP SIGNATURE-----

--
ubuntu-devel mailing list
ubuntu-devel@lists.ubuntu.com
Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel