← Back to team overview

maria-docs team mailing list archive

Re: Stub content on KB?



I used to subscribe to the view that stubs are "an easy way for
contributors to cherry pick work".

About four years ago as a MySQL employee I was involved in setting up and
contributing to the 'MySQL User Guide' at
http://forge.mysql.com/wiki/MySQL_User_Guide. I just did a quick review of
that wiki and don't see a single element added to the original content. Not
terribly encouraging.

In defence of stubs, I don't think the 'MySQL User Guide' was very well
promoted--it's hard to find, not immediately clear that contributions are
welcome and perhaps the size of the project is overly ambitious.

On 28 November 2011 16:14, Shaun McCance <shaunm@xxxxxxxxx> wrote:

> Hi all,
> What are your thoughts on adding stub articles/sections to the KB?
> For example, adding an article for how to specify account names
> without actually writing the content, along with a note to whoever
> comes along about what the article should contain.
> I've seen stubs work well in other docs efforts. They're an easy
> way for contributors to cherry pick work. But with the "everything
> is always published" model of a wiki-like KB, stubs can be annoying
> to average readers, like a 90s-esque "under construction" banner.
> Thoughts?
> --
> Shaun
> _______________________________________________
> Mailing list: https://launchpad.net/~maria-docs
> Post to     : maria-docs@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~maria-docs
> More help   : https://help.launchpad.net/ListHelp

Peter Lavin
Telephone: 1 416 461 4991
Mobile:       1 647 985 4991
Skype:        peter.lavin

Follow ups