Docs overhaul follow up - c-box, p-box duality

Roderick W. Smith rod.smith at
Mon Aug 29 12:10:11 UTC 2016

Hash: SHA1

On 08/29/2016 06:28 AM, Maciej Kisielewski wrote:
> Hey folks!

I agree that some renaming/restructing could be helpful. I found it
very confusing when I first started at Canonical on the Server
Certification team. It's been over two and a half years, I've
contributed code to the project, and I STILL find it confusing, in
part because of the naming issues you identify below.

> As I spent some time improving the docs, some concerns/question
> came to my mind. I would like to discuss them, and probably reforge
> them into future stories. It all boils down to Checkbox / Plainbox
> duality.
> Checkbox and Checkbox-Converged have practically the same
> functionality. Anyone using launchers knows they're running
> Checkbox. Yet, Plainbox is not only known to end-users, but it's
> also required, to run some scenarios, like: - starting a provider -
> running one, particular job - listing units
> As a result, end-users, or devs starting to hack something in
> Checkbox*, are getting perplexed.
> Then there's the naming issue. There are plainbox units, providers,
> and so on. Perplexity intensifies.
> I know that renaming stuff to be checkbox * would be a small
> revolution, so first I would like to move all Plainbox
> functionality (as in $ plainbox invocation) to Checkbox (-cli). 
> This way no one will be recommended to run plainbox at any point.
> Second step would be to transplant/copy Plainbox docs chapters
> related to units syntax (and all else not dev-related) to Checkbox
> docs.
> Third, the aforementioned revolution of renaming stuff, which might
> not be worth one's while.
> I understand why Checkbox / Plainbox separation came to be, but
> those two Checkbox are the only two real Plainbox applications, so
> I would like to make them easier to use for all clients and
> stakeholders.
> Oh, and BTW, internally I still want the split of core and app, as
> it is today.
> Any thoughts?

- -- 
Rod Smith
Server and Cloud Certification Engineer
rod.smith at
Version: GnuPG v2.0.22 (GNU/Linux)


More information about the Checkbox-devel mailing list