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

[Roderick W. Smith]

-----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-----