[[PageOutline(1-2)]]

= !CodeTalk =

!CodeTalk allows developers to have conversations about source code elements. They can mark code sections they are concerned about and annotate them. These annotations provide entry points for an informal discourse about the strengths and weaknesses of these sections and developers can work towards a conclusion on how to proceed on the raised issues.

[http://www.computer.org/portal/web/csdl/doi/10.1109/C5.2010.11 IEEE paper @ C5 2010]

= How to Install =
{{{
#!div class="wiki_infotable" style="float:right;"
||'''Environment'''|| ||
|| [[Image(media/icons/custom:squeak_16.png, title="Recommended Squeak Version", nolink, right)]] || 4.1, 4.2 Trunk ||
|| [[Image(media/icons/silk:application_home.png, title="Recommended Squeak VM Version", nolink, right)]] || 4.0.2 (win) ||
|| [[Image(media/icons/silk:cog.png, title="Recommended Cog VM Version", nolink, right)]] || ''not tested with cog'' ||
||'''Sources'''|| ||
|| [[Image(media/icons/silk:script_gear.png, title="Metacello Configuration", nolink, right)]] || [http://www.hpi.uni-potsdam.de/hirschfeld/squeaksource/MetacelloRepository/ ConfigurationOfCodeTalk] ||
|| [[Image(media/icons/silk:database.png, title="Repository", nolink, right)]] || [http://www.hpi.uni-potsdam.de/hirschfeld/squeaksource/codetalk/ CodeTalk] ||
|| [[Image(media/icons/silk:package.png, title="Needed Packages from the Repository", nolink, right)]] || !CodeTalk ||
|| [[Image(media/icons/silk:package.png, title="Needed Packages from the Repository", nolink, right)]] || CT-!MarkupBrowser (optional) ||
|| [[Image(media/icons/silk:package.png, title="Needed Packages from the Repository", nolink, right)]] || CT-Monticello (optional) ||
|| [[Image(media/icons/silk:bullet_go.png, title="Dependents", nolink, right)]] || [http://www.squeaksource.com/OmniBrowser.html OmniBrowser] ||
|| [[Image(media/icons/silk:bullet_go.png, title="Dependents", nolink, right)]] || [wiki:swautil SwaUtil] ||
|| [[Image(media/icons/silk:bullet_go.png, title="Dependents", nolink, right)]] || [wiki:swaobextensions SWAOBExtensions] ||
||'''Misc'''|| ||
|| [[Image(media/icons/silk:world.png, title="Website", nolink, right)]] || [http://www.hpi.uni-potsdam.de/hirschfeld/squeaksource/codetalk.html CodeTalk@SqueakSource] ||
}}}

Using Metacello, just run the following code in your workspace:
{{{
(Installer mc http: 'http://www.hpi.uni-potsdam.de/hirschfeld/squeaksource/')
   project: 'MetacelloRepository';
   install: 'ConfigurationOfCodeTalk'.
ConfigurationOfCodeTalk load.
}}}

If you want to try the latest (maybe unstable) development version, run this:
{{{
ConfigurationOfCodeTalk loadDevelopment.
}}}

'''Configuration groups'''

{{{default}}} ... !CodeTalk itself, Monticello integration, markup browser

'''System categories'''

{{{CodeTalk-Core}}} ... loader and shared preferences[[br]]
{{{CodeTalk-Editor}}} ... morphs and models to edit markups[[br]]
{{{CodeTalk-Events}}} ... system events that signal markup changes[[br]]
{{{CodeTalk-Model}}} ... markup database (other related model classes)[[br]]
{{{CodeTalk-OB-Commands}}} ... !OmniBrowser commands for context menus[[br]]
{{{CodeTalk-OB-Lists}}} ... custom lists in the system browser[[br]]
{{{CodeTalk-OB-Nodes}}} ... used in custom browsers, e.g., markup browser[[br]]
{{{CodeTalk-Tests}}} ... just tests[[br]]
{{{CodeTalk-Text}}} ... text-related classes (editor, styler, paragraph, morph)[[br]]
{{{CodeTalk-Text-Attributes}}} ... custom text attributes[[br]]
{{{CodeTalk-Text-Icons}}} ... inline icon morphs to be used in text morphs[[br]]

'''Version 1.1 (in development)'''

 * ...

'''Version 1.0'''

 * initial release
 * supports Monticello (as in Squeak 4.2 Trunk)
 * adds markup browser (custom OB-like browser)

{{{
#!div style="clear:both;"
}}}


= How to Use =

...

= Acknowledgments =
[[Image(media/icons/silk:user.png, nolink)]] To date, the following people contributed to this project: 
 * Michael Grünewald
 * Jens Lincke
 * Tobias Pape
 * Max Plauth
 * Stefan Richter
 * Christopher Schuster
 * Bastian Steinert
 * Marcel Taeumel