overthrowing the tyranny of alphabetical order in documentation systems
DESCRIPTION
Slides of the talk I gave at ICSME 2014TRANSCRIPT
![Page 1: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/1.jpg)
1
Overthrowing the Tyranny of Alphabetical Ordering in Documentation Systems
Boris Spasojevic, Mircea Lungu, Oscar Nierstrasz!Software Composition Group, University of Bern
![Page 2: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/2.jpg)
–Jakob Nielsen
“Alphabetical ordering must (mostly) die.”
2
![Page 3: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/3.jpg)
3
![Page 4: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/4.jpg)
4
The Refactoring Browser
![Page 5: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/5.jpg)
5
![Page 6: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/6.jpg)
6
![Page 7: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/7.jpg)
once in every ten years ten times every hour (?)7
![Page 8: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/8.jpg)
We wanted to reclaim !the time wasted in browsing through
alphabetically sorted methods…
8http://fc03.deviantart.net/fs14/f/2007/074/5/6/The_tick_tock_man_by_Phostex.jpg
![Page 9: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/9.jpg)
If we knew what methods developers are looking for, we
could improve the documentation accordingly.
9
![Page 10: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/10.jpg)
Usage of java.lang.Thread in !Qualitas Corpus
https://github.com/caracciolo/pangea/blob/master/demo/thread-stats.st10
Pangea streamlines studies!on multi-language corpora.
Introduced in !our SCAM 2014 paper.
![Page 11: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/11.jpg)
people fear change
11http://www.qvidian.com/sites/default/files/Resist-Change_0.jpg
![Page 12: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/12.jpg)
The Refactoring BrowserAugmenting
http://scg.unibe.ch/research/freq12
![Page 14: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/14.jpg)
14
Java Crawler
Smalltalk Crawler
Data Gathering
Module
DatabaseREST API
![Page 15: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/15.jpg)
15
def importance(word, frequency_list): if word in frequency_list: position = frequency_list.index(word) return position else:
Dynamically typed languages pose extra challenges
Smalltalk Crawler
Mining the Ecosystem to Improve Type Inference For Dynamically Typed Languages. Boris Spasojević, Mircea Lungu, and Oscar Nierstrasz. In Onward! ’14, ACM, New York, NY, USA, 2014.
![Page 16: Overthrowing the Tyranny of Alphabetical Order in Documentation Systems](https://reader035.vdocuments.mx/reader035/viewer/2022081720/5588cd2cd8b42aef6d8b46db/html5/thumbnails/16.jpg)
As a warrant that the approach works, we provide our own testimonials. (For now.) !We are still working on…!- Extending to classes /
Packages - Improving the type
inference for ST - Alternative orderings
https://github.com/cederigo/jatishttp://scg.unibe.ch/research/freq
More details !in the paper