Comment 114 for bug 240067

Hello everyone,

I've just done a big round of updating the LEP. Here's a summary of the changes:
 * Rewrote the "Rationale" to be a bit less strident and a bit more likely to convince folk around here to sponsor developmen
 * Updated to have a "User stories" section, which is something we're doing for all new LEPs
 * Pushed the markup requirements into "Must have"
 * Added a bunch of requirements that practically any off-the-shelf wiki would meet (page management, subscription management, printable pages)
 * Added a bunch of translation stuff to "nice-to-have"
 * Filled in the success metrics section
 * Moved implementation stuff into a separate section. Bazaar branches, wikkid, URLs.
 * Added lots of explicit must-have requirements for search

There were some debated points that I have made a decision about:
 * Attachments
   * These are essential, at least for images. https://wiki.ubuntu.com uses them, https://dev.launchpad.net/ uses them, wikipedia uses them.
 * Migration
   * Dropped this, but made "mass import" a nice-to-have
 * Bumped "privacy for wikis of private projects" to be a must-have

There are some requirements that I am unsure about, they are in the "Unsure" section. I have deleted some of the "discussion" there, because a lot of it boiled down to "I don't think so" and the document is getting pretty long.

OK, that's the summary done. Phew. Some more thoughts follow.

First up, I think we're making really good progress here in understanding what we want for our end users. The remaining points are things that, quite rightly, deserve some thought and conversation.

Second, the requirements we are gathering here are deliberately inclusive. We want to understand what it means to be finished, to have done this well. When someone proceeds with actually doing this, they will probably want to group the requirements together and deliver them incrementally, some one day, some another day. We

Third, it is genuinely important to set aside thinking about _how_ we'll do this in order to focus on _what_ we actually want to do. If anyone would like to think or wax eloquent about implementation approaches, they should please keep it out of the main section of the LEP. The ideal is that a LEP should be written in such a way that you could imagine three or four different implementation approaches.

Also, as a point of order, if you are making a comment on any wiki page, please say who you are and when you are making the comment, especially if "I think" forms any part of the comment.

Where do we go from here?

In no particular order, we need to:
 * Resolve the "unsure" requirements
 * Evaluate some choices of wiki technology (wikkid, mediawiki, moin, rolling our own, ...)
 * Break the LEP into sub-features / milestones / whatever. I'd suggest universal wiki markup as the first.

I really do hope this helps. Good luck.

jml