From: Jack D. P. <jac...@ps...> - 2010-01-11 18:47:01
|
I found this when I was doing a concept patch for format=tables - the # parameter exists in lists and in the proposed patch for tables under http://wiki.montcopa.org/TestWiki/index.php?title=Advanced_Table_Formatting_ for_SMW_Queries, but I only found it because I was patching. I documented it here (http://wiki.montcopa.org/TestWiki/index.php?title=Advanced_Table_Formatting _for_SMW_Queries#Parameters_Passed_to_Table_Row_Templates), but found no other documentation for it. > -----Original Message----- > From: Markus Krötzsch [mailto:ma...@se...] > Sent: Monday, January 11, 2010 12:33 PM > To: sem...@li... > Cc: Daniel Friesen > Subject: Re: [SMW-devel] [Semediawiki-user] Random sort in #ask > > On Freitag, 1. Januar 2010, Daniel Friesen wrote: > > I've taken to the less lazy tactic of making postings to > the mailing > > list hoping someone else who is better at writing will do the > > documentation ;). > > > > Hmmm... maybe I missed one. Is my feature of the {{{#}}} > variable in > > #ask templates documented? > > Look as if the person who documented it is not on this list, > or it is not documented anywhere yet. I don't recall that feature. > > -- Markus > > > > > ~Daniel Friesen (Dantman, Nadir-Seen-Fire) > > [http://daniel.friesen.name] > > > > Markus Krötzsch wrote: > > > Dear developers, > > > > > > I came across the "hidden feature" of random sorting again today > > > when I cleaned up the related code and fixed various > issues that it still had. > > > It was impossible to disable this performance-critical feature in > > > SMW, although a global variable had been introduced for > that purpose > > > (it was never used)! > > > > > > I traced back the code and found that it had been > committed based on > > > a patch that was submitted to Bugzilla (not blaming > anyone here, the > > > committer may even have notified one of us core devs to check the > > > code ...). Obviously, the code was not properly reviewed > or tested, > > > and the feature was not documented until recently. We > should really > > > try to avoid such cases in the future. Especially, any Bugzilla > > > patch should be reviewed by a developer who is familiar with the > > > affected code before being committed. I know that it can be > > > tempting: someone offers a patch for adding a long-wanted > feature, > > > and it is so easy to just commit it without further ado -- > > > unfortunately we need to resist this kind of temptation ;-). > > > > > > Since we are heading toward SMW 1.5, I would also like to ask all > > > SMW- committers to double-check that all new features that you > > > committed in the past months are mentioned in the file > > > RELEASE-NOTES, and documented on semantic-mediawiki.org. It is > > > really a pity if useful features go unnoticed simply because we > > > forget to go that final mile of documenting them properly. > > > > > > Thanks for your support, > > > > > > Markus > > > > > > On Freitag, 11. Dezember 2009, Philipp Zaltenbach wrote: > > >> Hi, > > >> > > >> I have updated the documentation at semantic-mediawiki.org. See > > >> * > > >> > http://semantic-mediawiki.org/wiki/Help:Inline_queries#Sorting_resu > > >> lts > > >> * > > >> > http://semantic-mediawiki.org/wiki/Help:Configuration#Query_setting > > >> s > > >> > > >> It would be nice if anyone could double check. > > >> > > >> Regards, > > >> Philipp > > >> > > >> Patrick Nagel schrieb: > > >>> Hi Alex, > > >>> > > >>> On 2009-12-11 01:38 UTC Alex Kozak wrote: > > >>>> I'm wondering if there is a way to do a random sort in #ask > > >>>> queries (maybe with something like order=random), and > if not, if > > >>>> anyone has any ideas on how to accomplish this (sanely) with > > >>>> templates and parsers? > > >>> > > >>> Did you try 'order=random'? It should work in current versions, > > >>> but for an unknown reason it's currently not documented on > > >>> semantic-mediawiki.org. > > >>> > > >>> See http://old.nabble.com/Random-Sort-in-SMW-1.4-td20670044.html > > >>> > > >>> Patrick. |