Menu
▾
▴
Re: [Tikiwiki-devel] New contributions or track-changes?
|
From: Xavier de P. <xav...@ub...> - 2010-07-30 08:51:57
|
Hi all: I re-send to tikiwiki-devel list, with my answer here and without the "Re: [Tikiwiki-cvs/svn] SF.net SVN: tikiwiki:[28078] trunk" from the subject (to avoid having some of our filters put this message in the [Tikiwiki-cvs/svn] folder), beyond the possible bug Sylvie found (as reported in the [Tikiwiki-cvs/svn], when using "single quotes" it seems... never ending issue with single quotes...)... I would like to suggest Jörn that you take into consideration that the former "Contribution" feature ("Contribution type" to be exact, it could say - http://doc.tikiwiki.org/Contribution ) can be on, as well as the "contributors" linked feature, so that when a user writes some text, some other users are to be credited as co-authors (they were called in Tiki "contributors", even if they can be pure coauthors of the same idea, text, etc. , but only one user posted the content to the Tiki site). This should be taken into consideration, imho, when doing the "magic" to display authorship stats, etc. Moreover, if the "contribution type" is on, it would be very helpfull: (1) if those contribution-type-tags are shown in the popup box when mousing over a text (so that it would be much easier to review at any point if they are properrly set by students), with a link to edit the contribution tag/s of the wiki page version where they belong to, as allowed in the "Action Log" page when contribution types are on. (2) if the contribution type can be optionally included in the short statistics table on top of the table. And as I offered a few days ago, in order to allow other devs to see quickly what we are talking about, I added that screenshot and short nhote to the work-in-progress Tiki6 page on doc.tw.o: http://doc.tikiwiki.org/Tiki6#Contribution:_quot_Who_wrote_What_quot_in_any_wiki_page_version As I told you a few days ago, Jörn, and Carsteen, thanks for developing this "gorgeous" feature which is going to be extrememly useful in educational scenarios. My 2 cents Xavi Al 27/07/10 13:51, En/na Jörn Ott ha escrit: > Hello Sylvie, > > > Am 27.07.2010 12:47, schrieb Sylvie Greverend: > >> On Tue, 2010-07-27 at 11:26 +0200, Xavier de Pedro wrote: >> >>> Hi Jörn: >>> (adding Sylvieg, LPH and Marc in cc, just in case they don't get it >>> through the svn list) >>> >>> This work you have done is more than excellent: GORGEOUS!!! I'm so >>> impressed! I remember years ago dreaming of some "wiki blame" feature >>> in Tiki.... ("blame" as in "svn blame", not as in "blame" in >>> psicological context, of course). >>> >> I suppose I missed a part or I have a bug: how to know the author of a >> part of a text If I do not scan each history. >> > This is exactly what this page does. It starts with version 1 and looks > for the last version of the same author to begin with the analysis. It > then creates an array with an element for each word/whitespace block and > stores not only the word, but also the author (= the user who saved the > page), ignoring at this point all {include} and {author} tags. > It determines now the last version of the next author and does a diff > between the existing array and the added parts (using histlib/diff etc.) > marking deleted words of the previous version as deleted and credit > added words to the new author (= user who saved this version). > The program repeats this step until it arrives at the last version or > (if provided) the requested version of the page. At this point, the > preserved {author} tags are being parsed and the words in between those > tags are credited to the name given in the block (who must not > necessarily be a wiki user). During this stage {include}d pages are > being parsed (simple recursion) and inserted into the document array. > The output function of the document class can now generate different > types of data: a simple array of words and whitespaces, a 1:1 copy of > the data structure (for example for the {include} part or as a wiki text > using the {author} plugin with the render parameter set to show the > different authors in different colors. > > >> I was not able to do it on >> my local. I only see the author that added texts and the authors who >> have deleted parts in this history but in not all history. Xavi if you >> have 5mn on irc to show me. Thx >> > What I do ist not go through every version done by the same author, as > this would mean a lot more processing and was irrelevant for building a > statistics/analysis of "who wrote what". > > Maybe we should add another option to parse every version so you can see > what the same author deleted/added between version 1,2,3,4 he wrote himself. > > >> I have also another question: >> How do you check that the AUTHOR plugin has been correctly inserted >> because it is the responsibility of the one who inserts it. Is there a >> control between the AUTHOR content and the real author. And is there a >> tool to split a plugin in case somebody adds something is the middle of >> a part of another one.... I do not understand really the need of an >> AUTHOR plugin in fact. It could have been done without the plugin by >> analyzing the history. I suppose I did not understood something. >> > I use the {author} plugin for two things: > 1. Render the output in different colors when showing the history. > 2. Allowing a user to manually credit someone else for a text he is > copying/pasting from somewhere. For example if I write a document about > Goethe (let poor old Shakespeare ot of this for once) and I cite a > longer text, I can credit this text to him. This allows to see how much > of my document is my own work and how much I cited. I thought this was > easier then creating another tiki user Goethe just for inserting a citation. > > >> I will wait for the doc cdrwrite said he will do >> (btw I began http://doc.tikiwiki.org/Pluginauthor >> or meet somebody on IRC >> > I am on IRC (using the nick JoernOtt for official/company business > though), I will ping you there. > > >> Thanks >> sylvie >> >> >> >> >>> This will help a lot in pedagogical scenarios... (-> >>> http://edu.tikiwiki.org ...), so for me (now speaking as teacher at >>> university) this is a reason to go for tiki6svn in mid september (even >>> before the public release), so that I can use it with my students (I'm >>> fed up with accepting that I don't have the time to identify who wrote >>> the important parts and who just wrote "poor" content...). >>> >>> And coming back to the potential confusion in users, imho, the current >>> "contribution" feature in Tiki should be renamed as "Contribution >>> types" (or similar; this was my initial request, in fact, but due to >>> some confusion, maybe, or due to my Catalanglish, it got named >>> everywhere as "Contribution"). And yours could exist as it is now? Any >>> other opinions? >>> >>> Both features should coexist, and can benefit from each other, imho. >>> As a teacher, I will use both! >>> >>> Moreover, I'm attaching a screenshot of a working example from your >>> testing site, Jörn (those quick& dirty screenshots are good to >>> showcase the new features while in beta, and when no one make better >>> documenation, they seem to survive and become the official screenshots >>> of those features, btw!). I'd like to ask you permission to use it to >>> document in doc.tw.o the new feature coming in Tiki6. As well as your >>> text from your previous message (below), as a draft for the >>> documentation page on this feature. >>> >>> Last, but not least, I remember that in the last TikiFestBarcelona2 >>> Louis-Philippe and Marc talked about the "wiki trust" feature that >>> some other developers did for other wiki engines and in other computer >>> language, but which could, somehow, be used from Tiki... >>> Louis-Philippe and Marc, how this "wiki trust" engine could/would fit >>> in this context? I didn't see it in action, but does/could it provide >>> anything different (or compatible, suplementary...) than the code >>> already contributed from Jörn& Carsteen? >>> >>> Xavi >>> >>> P.S. Thanks Jörn for the access to your testing site to see the >>> feature in action. >>> >>> >>> Al 27/07/10 09:00, En/na Jörn Ott ha escrit: >>> >>>> Hallo xavi, >>>> >>>> >>>> >>>>> cdrwhite, could you please expand the goal& roadmap for this feature >>>>> (is it written anywhere?), compared to the existing "Contribution" + >>>>> "Action log" features which have been in Tiki for a few years already?: >>>>> >>>>> http://doc.tikiwiki.org/Contribution >>>>> >>>>> http://doc.tikiwiki.org/Action+log >>>>> >>>>> (they both allow you to report contribution sizes, but also per >>>>> contribution types) >>>>> >>>>> >>>> Those features track what the user does when he does it (Action log) or >>>> allow to classify his contribution to a wiki page when he is editing it. >>>> The contributional stats however take the page history and current page >>>> to generate a series of diffs (as you do when comparing one version >>>> against another) to build a map "who contributed which word". These >>>> changes can be visualized like the "Track changes" feature in Office >>>> programs (also showing deleted parts). Using the {AUTHOR()} wiki plugin >>>> manually, an author can credit a part of the text he is writing/citing >>>> as contribution by another person. >>>> >>>> This new is relevant if you want to "pay" authors based on what they >>>> contributed to a final version of a page. In the action log you can see >>>> how many bytes were added by a person and how many were removed but not >>>> who wrote those bytes originally. And there is no way of determining >>>> which of those bytes were whitespace or formatting instructions and >>>> which were printable characters or how many words the author wrote. >>>> >>>> For more detailed information about the intention of this feature, you >>>> can contact Carsten Aevermann (see cc) >>>> >>>> >>>> >>>>> To me, names (at least, I wonder if code also) are overlapping, and >>>>> could cause unnecessary confusion with our users and tiki site admins. >>>>> >>>>> >>>> I agree, the name for this should be chosen so it can be distinguished >>>> easily from other features. How about calling it "Track changes" as in >>>> Office programs? >>>> @Carsten: what do you think about it? >>>> >>>> >>>>> Thanks >>>>> Xavi >>>>> >>>>> >>>> Mit freundlichen Grüßen >>>> Jörn Ott >>>> ------------------------------------------------------------ >>>> Ott Consult UG (haftungsbeschränkt) >>>> Hauptstr. 11e >>>> 53604 Bad Honnef >>>> Telefon: +49 2224 968368 >>>> Telefax: +49 2224 940874 >>>> E-Mail: mailto:in...@ot... >>>> WWW: http://www.ott-consult.de/ >>>> Amtsgericht Siegburg HRB 10574 >>>> >>>> >>>> >>>> >>>> ------------------------------------------------------------------------------ >>>> The Palm PDK Hot Apps Program offers developers who use the >>>> Plug-In Development Kit to bring their C/C++ apps to Palm for a share >>>> of $1 Million in cash or HP Products. Visit us here for more details: >>>> http://ad.doubleclick.net/clk;226879339;13503038;l? >>>> http://clk.atdmt.com/CRS/go/247765532/direct/01/ >>>> >>>> _______________________________________________ >>>> Tikiwiki-cvs mailing list >>>> Tik...@li... >>>> https://lists.sourceforge.net/lists/listinfo/tikiwiki-cvs >>>> >>>> >> >> > > > > ------------------------------------------------------------------------------ > The Palm PDK Hot Apps Program offers developers who use the > Plug-In Development Kit to bring their C/C++ apps to Palm for a share > of $1 Million in cash or HP Products. Visit us here for more details: > http://ad.doubleclick.net/clk;226879339;13503038;l? > http://clk.atdmt.com/CRS/go/247765532/direct/01/ > > > _______________________________________________ > Tikiwiki-cvs mailing list > Tik...@li... > https://lists.sourceforge.net/lists/listinfo/tikiwiki-cvs > |