Docs overhaul follow up - c-box, p-box duality
Roderick W. Smith
rod.smith at canonical.com
Mon Aug 29 12:10:11 UTC 2016
-----BEGIN PGP SIGNED MESSAGE-----
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 canonical.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.22 (GNU/Linux)
iQEcBAEBAgAGBQJXxCYjAAoJEFgyRI+V0FjmnzMH/ReKhbsEvhE17SqR0lofL4Qu
G3S9/B12xfpxwqWM2tCJkzwzhYjfp82LwpB/LXh9+HdwV++HyKESEGsch7fGIauU
d6vh2m40XeFsmQV49YW/9oF6bEtMVRifH/SzVfqj6CJ9vemcQt4K4oXu1Z47MsFa
ZhzWISWeuRjIeSKL7bOy5Jy0//66MvbNJgyUtucH5iImcuKUinsiq+BJPLcMvUuG
itDFB1YF3XvcrLafFCvReY/9EOeq1UvtrM34mBdOeaJa2d1SVOFUCNtbHGcRU30x
xVACn7IiQa5ui8JPbDNkde1dCPHgPMotaw909aMk4MP73zh/a/NFBmvfvkyXeUM=
=THIe
-----END PGP SIGNATURE-----
More information about the Checkbox-devel
mailing list