Therefore, add a description of your changes to the page summary. To keep the summary fresh, remove descriptions of changes older than the PeerReview period of two weeks. To keep the summary informative and useful, digest it when it gets too long.
But, these points are merely guidelines, not hard-and-fast rules: DigestedSummary is an on-going experiment, and we welcome experimentation and ideas in this space. For instance, one useful pattern that has emerged is using the digest field as a kind of MiniBlog?, letting people know when a WebLog-like page has updated. In these cases, one can delete older entries from the digest entirely, as readers only need to see the latest entry to know new entries have been added. Cutting out the older entries, even if they are only a few hours old, is a neat way of preventing a hot MiniBlog? from HijackingRecentChanges.
During active discussions, certain pages are modified several times in one day, which is displayed on RecentChanges as only one entry in the listing (unless you request to see all changes). This means that readers coming much later are often unaware of what has gone on during the day or even the week. A ChangeSummary? provides a short amount of metadata about each change to help those who are skimming RecentChanges to tell quickly what has past. However, as described, this only helps them for the last change, not the whole history of changes, so only RecentChangesJunkies are given an opportunity to understand what has happened. We do not like junkies; they bring too much social pressure to the wiki. We want to allow people to remain away from the site as much as is reasonable for them to still contribute without wasting their time keeping up to date with each micro-contribution. Listing all the summaries underneath each page's entry in RecentChanges leads to a lot of unrelated and redundant entries that could be simplified, especially when someone enters an edit & view & save cycle, creating multiple new versions with the same summary.
A community solution is to preserve the summary between edits. This contrasts the previous situation where new summaries are created for each edit, even successive edits by the same author. New interesting changes can be appended to this summary as a running discussion. The summary field becomes a digest of the changes to the page, a chronicle (journal article, GroupWeblog?) of what has transpired on that page in recent history. Really old or irrelevant happenings can be manually removed, and new interesting things can be appended in a natural way (rather than simple sequential listing). This is closer to the wiki way where everything can be refactored.
Since RecentChanges is not a part of the WikiNow, but a mechanism to enable PeerReview and community, it makes sense to start a new summary when the last revision is old (say, the KeptPages timeout).
Implementing this is as simple as enlarging the summary box, renaming it to "Digest", and filling the field with the previous summary.
See also DigestedChanges.
On EmacsWiki:2005-05-01 I have a user reporting that most people don't actually change the summary, resulting in misleading summaries. I'm not yet sure how to deal with it -- maybe the old summary is in fact what low frequency readers (like Bayle or Scott) would expect. Then it is just a matter of re-interpreting what the summary is all about. As a workaround I suggested to further reduce the "summary life-span" to a mere two or three days -- much shorter than the kept pages expiry. After some more discussion I decided to reduce the summary life-span to four hours.
Well, I have people explicitly saying that they don't want a summary of what is going on -- they want a comment on the last edit only... I tried to explain the concept without renaming the field. But I don't think they like it.
As for the size of the summary field, I think your browser is failing to take note of the CSS I'm using -- my edit field is three lines high. I really should test in some other browsers, too. On IE at work the edit field is two lines high. I wonder what you are using. -- AlexSchroeder
Ah, I will test in Safari when I get back home. I also use the following, now:
textarea[name="text"] { width:100%; height:80%; } textarea[name="summary"] { width:100%; height:3em; }
Looking at how a typical RecentChanges entry looks like, I note a pattern:
What I see is that we have adopted as a convention not a "digested summary" but the concatenation of edit summaries. It seems to me that we could just concatenate a small number of old-style edit summaries, prefix each with the respective author, and get the same result.
Turn it into:
Instead of what we have now (see example above).
Heh. I was only interested in major changes, of course. -- AlexSchroeder
Saw you asked the question about why another person did not like it. Well, in my case, I will like it better if I can use a 1 line display like before. Sometimes it is better to use the new format, if the digested summary has lots of stuff in it. Thanks for listening -- DavidLiu
I was a bit harsh earlier, but yes I do like the new design "too".
-- DavidLiu
On the theory that the main problem with the alternate scheme was it being too busy, I've changed it again. This time, the digests are not emboldened, only on a gray background. (I promise that it's easy to restore the original!) -- ChrisPurcell
Does the digest blank itself automatically after a few changes, or what?
To be honest, I prefer the old system. -- EarleMartin
So. At present, the digest says "Earle, Sunir and Alex provide some feedback for this feature". Should I now... add something, since I'm replying to you? Replace it entirely? Or leave it, since it already covers this discussion we're having?
I think what I don't like about this is that it makes me hesitate before saving a page. The older system was a no-brainer. -- EarleMartin
I'm not sure I'm grokking how this works either. I am feeling strongly it's somehow the wrong way around. Individual edits are individual, and need individual summaries. I am still interested in a global summary for a collection of changes (DigestedChanges). (apparently) Ward originally intended Wiki:RecentChanges to work this way, which is encouraging. -- SunirShah
The one problem I am seeing right now is that there are two types of change summaries. The summary for this change, and the summary for the collection of changes that comprise the event. I find myself not writing summaries for my edits, which makes PeerReview harder, I think. If we did DigestedSummary instead for each section on DigestedChanges that refers to this page, that would make a lot more sense. And at least with DigestedChanges, the DigestedSummary would be for all the pages involved in this event at once (almost like a SuperPage?). -- SunirShah
I think there's value in writing summaries of each change. I will admit that this doesn't have to be a special interface, merely a convention. Making point form notes that can later be reworked once they resolve into something coherent. Suppose the summary was parsed as WikiSyntax? I admit this is a pain with UseModWiki. -- SunirShah
It doesn't support it. Watch. -- SunirShah
Maybe a solution to the confusion about how to use the summary, as well as how MinorEdits tend to obliterate the summary, not to mention my reluctance to edit the summary now when I can't figure out what it is saying, is to have two summary fields. Have a one-liner for the current change, which can be applied to minor edits if so chosen. Return the MinorEdit checkbox. Have a textarea for the global summary. I think I actually proposed this before, w.r.t. DigestedChanges. -- SunirShah
I don't like 'digested summary'. I think I said so before, but it's been lost. Two objections: It makes the editing process more hard work. This is not good for wiki newbies, for whom even the simplistic idea of entering an edit summary is too much to bother with. The page history display becomes cluttered with long summaries, where before we had a few words appearing next to some of the edits. Basically the whole wiki design loses some of its elegant simplicity. I can see some advantages however, and so it makes sense to experiment with it here on meatball, where most of us are experienced wiki users, open to new ideas/features. I'm surprised the group has stuck with it for so long though.
Anyway I notice the OddMuse engine developers have adopted this now, which means new wikis will start appearing on the web, with this design modification. Was that the intention? It's a step backwards if you ask me. -- HarryWood
I also noticed this with a recent OddMuse update and have no experience with it outside that. OddMuse's implementation seems pretty confusing and inconsistent to me. Until being told about this page explaining what is going on it was really strange. Revision notes were now sticky but only sometimes. The new multiline revision notes text box was one of the first things I noticed that seemed odd. It always used to be a summary/short note, you don't need a lot of room. Some of this I am sure is due to the implementation and can be improved, but being consistent is important.
What I found really annoying is that new edits sometimes loaded up the revision notes with the newly added text including any formatting codes or links. Where I have noticed it is a spammer's edit and they are likely just loading any textarea with their identical spam. Whatever the cause it certainly clutters up the revision history. If this is caused by the spammer attacking any textarea it certainly should be something to think about. How easy is it to revert an overwritten digest summary?
I don't know that I agree with Harry's worry about newbies. They can and probably will just ignore it since they won't understand it. I think that actually extends to most everyone, not for misunderstanding it, but because it is inconvenient. A few words for a summary is usually all that a revision needs. That isn't really useful for an RSS feed though. Other than the RSS feed use of the digest, it reminds me of the talk pages of MediaWiki. Talk pages are good for some wikis, others don't need them. I think DigestedSummary may be like that, I hope it is optional if it stays around. Of course, now it would have to be backward compatible with the digest for those who got it in an upgraded. Truncating would be good enough probably since those who would be going back to the old way probably didn't use the digest as intended.
It may have already been suggested, but an alternative that could provide something for the feed is to concatenate the edit summaries from the last several edits (based on a similar time scale DigestedSummary is already using). People would have to make their edit summaries a bit more descriptive, but either way things are changing that people will have to get used to. -- JoeChongq?
Comment moved to DigestedSummaryEmpiricalResults
This is mostly copied over from [our wiki] where we were discussing how digests affect [WikiMinion], RichardP?'s antispam bot. WikiMinion? currently uses the summary field to note what action it took (such as revision it reverted to) so that a human can more easily diagnose and correct mistakes made by the robot. Richard said "only one or two wikis protected by WikiMinion? are running a new version of OddMuse (and hence are now theoretically using digested summaries) and they're so low traffic that they're pretty much always behave like a wiki that does not use digested summaries."
Assuming that digesting is extended to other wikis such as MediaWiki, especially Wikipedia since they use a number of bots for various purposes, there needs to be some standard way for bots to leave information. A bot is not capable of writing a proper digest, all it can do is overwrite or append to the previous digest.
The edit page here mentions a way of recording non discussion changes like this by using brackets.
But I really don't think that information belongs in the digest. The purpose of the digest is for giving an understanding what has been going on lately on the page and providing a meaningful RSS feed. For those purposes the digest is good if used as intended. I don't think information about copy editing and spam cleaning belong in the digest, but there is no other way of recording that they took place. They didn't add anything to the discussion or evolution of the page so why should they be included in the digest?
While overall revision history may be more informative, page histories are less informative. The revision histories are no longer relevant to a single revision anymore. Instead of looking at short notes you must read the longer digests and find what changed between them to locate the revision you want. Are we going to need digest history diffs? That wouldn't even make sense. -- JoeChongq?
ChrisPurcell said on DigestedSummaryEmpiricalResults that the history page may be the right place.
When people edit a page, their first reaction is to write a log entry into the summary field. They summarize their change only, by adding their text, or they think their change does not require any explanation. The actual numbers are 44% and 15% respectively, but we need to account for the fact that 29% of the changes where follow-on changes, ie. the same author deemed it unnecessary to write a summary, which might indicate that the the actual ratios are 44/71 and 15/71 instead of 44% and 15%.
It seems to me that the ones editing the pages are not really interested in summarizing recent discussions in the summary field of a page.
Nevertheless, there seems to be interest in providing such summaries. RareVisitor?s would like to see them on recent changes. So that leaves us with two questions: Who would write them, and where would they write these summaries? If we assume that those summarizing the activities are not the ones writing the page, then I think it should be ovious that the edit page is not the right place to do it. Furthermore, many wiki implementations will not save an edit unless the text of the page has changed. There is a place where we can look at changes to a single page, the history page. If we could edit the current summary (overwriting the summary for the last edit) right there, then maybe that would give the right people the right information to write the summary, and put the summary where the rare visitors will actually see them: On the last edit visible on RecentChanges. -- AlexSchroeder
I agree with your point about spam reverting, if the summary is a target for spam or vandalism. As for the numbers, where do you disagree? It seems to me that 44% just added to the summary, 15% did not provide any, 3% digested it, and we can ignore the others (misuse, spam, and follow on changes). -- AlexSchroeder
A logical next step is to allow arbitrary wiki syntax in the summary field. We would then 1) parse this syntax on the history page; 2) parse it on RecentChanges; and 3) emit it in the RSS as CDATA rather than raw text. The net effect is that, if you choose to use the summary in such a way, you can make your RecentChanges and RSS much more bloglike.
EditDigests have been a part of MB for nearly four years now (wow). Concurrent with the comments above, I made other changes to MB to support digests, notable EditCategories replacing MinorEdits, and a greatly reworked History page with integrate page diffs, showing EditDigest diffs. So my question to the current MB community is: do you think these changes have worked out for the better? Is RecentChanges now better for non-RecentChangesJunkies? Is doing peer review easier? -- ChrisPurcell
I'm mostly a lurker, but I have to admit I main look at the author and then the actual page diff. Although the digests don't get in the way, they aren't a large difference to me. -- RadomirDopieralski
The history page is excellent, much better than in any other wiki I know, the only thing I miss is a 'revert' button for fast despamming, but I'm well aware of why it's not made that easy. -- RadomirDopieralski
I haven't been here very long, but I have to say I really like the way the history page works here compared with the UseMod system. -- NathanielThurston
Does the RSS feed link on RecentChanges not work for you, Hans? -- ChrisPurcell
Coming here rarely, I am always a bit confused about things. I'm sure it's easy to look up, but since you're asking for input from non-RecentChangesJunkies for Meatball, I would have to read up on EditCategories every singe time and never do. Effectively I no longer know how to make minor changes and am bewildered by the line "Bracket copy editing or spam reversion with [CopyEdit: ...] or [WikiSpam: ...] (see EditCategories)."
As for the history pages, I'm unhappy in how they break my established work pattern. I usually look at RecentChanges and click on the diff links for pages. In Oddmuse, I can see the diff, and read the rest of the page. When I look at the [TeaTime diff], I don't even know where to click in order to look at the real page. It took me several seconds and two scrolling up and down, trying to find a link in the header or footer, until I realized that I needed to click on the top-most time ("1:37 pm") in order to view the current revision. I don't like how Oddmuse shows the diff followed by the page text, because it makes it hard to understand context in large pages. On Meatball, this is made even more difficult because I have to read the diff, scroll back to the top, click the timestamp, and now find the phrases I remember from the previous page to get some context.
If anybody wants to contact me regarding the above feedback, feel free to mail or instant messaging; I'm not a regular reader on this site anymore. -- AlexSchroeder
---
Usability suggestion for making things newbie-friendly without any fundamental change to the system: Only show the EditDigest if the user checks an "Advanced" checkbox. By default, show something that looks more like a traditional Wiki (EditSummary?, CopyEdit checkbox). Stick whatever is written in there on the end of the EditDigest (in a CopyEdit segment if the checkbox is selected). -- AlicePurcell?