Bringing squeak-dev into your image
A project originally conducted in the course of the Live Programming Seminar 2021 @ HPI. Many thanks to Marcel Taeumel for his diligent mentoring and advice!
Squeak Inbox Talk runs on Squeak 6.0 and newer versions. We follow the trunk-based development style of Squeak and strive to deliver full support for the latest Squeak Trunk. New features are only supported by the Trunk version of Squeak Inbox Talk. Older versions and releases of Squeak will only receive urgent fixes.
To install and start Squeak Inbox Talk, go to the main docking bar and choose Tools > Squeak Inbox Talk.
-
Get a Squeak image (Squeak 6.0 or newer)
-
Install the latest system updates.
-
Open a workspace and evaluate the following:
-
Squeak Trunk:
Metacello new baseline: 'SqueakInboxTalk'; repository: 'github://hpi-swa-lab/squeak-inbox-talk:main'; load.
-
Squeak 6.0:
Metacello new baseline: 'SqueakInboxTalk'; repository: 'github://hpi-swa-lab/squeak-inbox-talk:squeak60'; load.
-
Alternatively, you can download the one-click image from the latest release and run it with zero installation effort.
For detailed information on how to use the tool - in case this should not be straightforward -, see the usage documentation.
If you want to learn more about how the Squeak development process looks like, how Squeak Inbox Talk integrates with the other tooling for trunk development in the Squeak, and how you can make your own contributions, you may also want to check out these resources:
- Squeak/Smalltalk - The Squeak Development Process: https://squeak.org/development_process
- Contributing to Squeak: In the image (Squeak 6.1Alpha and newer), open the help menu in the docking bar and click on "Contributing to Squeak".
Many Squeakers have experienced the following troubles in the past:
- Tedious navigation on the list: Where has this patch gone? Can someone remember where we were discussing this funky thing recently?
- High entry barrier for new contributors: You need to sign up on the mailing list to follow discussions.
- Hard review process: Notifications and discussions appear in your email client, but if you want to check out some code, you will switch to your image, of course.
Squeak Inbox Talk attempts to solve all these issues by merging all relevant artifacts in Squeak, including emails and Monticello contributions, allowing developers to explore them interactively. It comes with a free-text search and several powerful filters for aspects such as packages, review state of a contribution, and your personal involvement. These filters should make it easier to survey certain domains, gain a better understanding of the connection between inbox versions, or keep track of your own proposals.
Basically, Squeak Inbox Talk is implemented by reusing and assembling together the following existing solutions: Squeak History, a project originally developed by Marcel (mt) that scrapes and processes all mailing list conversations from the mailman archives; the SMTPClient in Squeak for sending messages; and the Monticello infrastructure, which remains the heart of our development workflow. Optionally, further components such as IMAPClient might follow later. On top of this, Squeak Inbox Talk adds a convenient layer for exploring and filtering conversations and contributions.
This repository includes an optional plugin that enhances the browsing experience by contributing features such as semantic search, similar conversations, and AI-generated summaries of conversations to Squeak Inbox Talk. The plugin uses the SemanticText package and OpenAI's APIs for text embedding and generation. You can enable the plugin by turning on the "Semantic search in Squeak Inbox Talk" option in the preferences. This feature is currently in a very early stage. Feedback and ideas welcome!
- This project is proud to use smalltalkCI and the create-image GitHub action.
UPSTREAM.mdcontains a list of contributions that were made to upstream dependencies of this repository in the context of this project.