Topic on Talk:Development process improvement/Communications recommendations

RobLa-WMF (talkcontribs)

I'm not terribly enthusiastic about renaming mailing lists, only because it's difficult to rename a list and to preserve URLs to the old mailing list content. Since we have so many old conversations that we often reference, we should probably have a pretty high bar for renaming an existing mailing list. For example, I don't believe changing "mediawiki-l" to "mediawiki-users" would clear that bar.

Guillom (talkcontribs)

I disagree that "we have so many old conversations that we often reference". A link search for http://lists.wikimedia.org/pipermail/ on mediawiki.org return many results, but almost all of them are links to release announcements. They appear on many pages only because they're included into "news" templates. They can hardly be considered useful reference materials (which should reside on the wiki anyway).

In any case, I had done a little bit of research about list renaming before writing these recommendations, and that's why I recommended very few of them. Renaming Mediawiki-api to Mediawiki-api-users and mediawiki-l to mediawiki-users is obviously optional (notice the "perhaps" and the question mark respectively in the table :). That said, renaming "mediawiki-cvs" to "mediawiki-commits" would make sense, and shouldn't be too much of an issue. It will teach us not to use tool-specific names in the future :) FYI there are about a hundred subscribers.

To be honest, I'm more interested in retiring or merging unused lists, and splitting lists that mix different topics.

RobLa-WMF (talkcontribs)

A general purpose search is more appropriate to my point. Regardless of where these discussions belong, many are where they are, and it's silly to break links to them if we don't have to. Mailing lists are actually some of the best ad hoc reference materials on the web, and we shouldn't diminish their role. Obviously, getting material onto wikis is better, but that isn't always realistic, and often the email conversation ends up being clearer to understand than documentation written to purpose.

Retiring lists generally seems fine, so long as we keep the archives around.

Guillom (talkcontribs)
Obviously, getting material onto wikis is better, but that isn't always realistic, and often the email conversation ends up being clearer to understand than documentation written to purpose.

We're obviously reaching a difference of opinion here.

RobLa-WMF (talkcontribs)

So do you think it's realistic to get every insight from every piece of email onto a wiki in a uniformly cleaner and understandable form than it originally appeared on the mailing list?

Guillom (talkcontribs)

What I think is that there are more important things to spend time and energy on.

Zakgreant (talkcontribs)

I chatted with RobLa about this last week and uncritically agreed with him. Perhaps I was in an overly agreeable mood that day. :)

Thinking about things a bit more,I'm a fan of putting more things into the docs and having less adhocumentation on the mailing lists.

Every time that someone can answer a question by pointing to a URL, a few good things happen:

  • the contents at the URL can be updated over time. Mailing content goes stale fast and can lead people very far astray.
  • more link love goes to the right URL in the docs, not to the mailing list archives.
  • the list readers learn about the docs and how to read them.
  • the listies get feedback when the docs suck.

All these things make it so that there are way better returns on updating content.

Lists are still really important and something discussions in a list can't be captured easily in documentation. However, most of those discussion aren't really documentation fare.

Reply to "Mailing list renaming"