← Back to team overview

ubuntu-sdk-bugs team mailing list archive

[Bug 1395533] Re: Kit Wizard Description needs to be simplified.

 

** No longer affects: qtcreator-plugin-ubuntu

-- 
You received this bug notification because you are a member of Ubuntu
SDK bug tracking, which is subscribed to qtcreator-plugin-ubuntu in
Ubuntu.
https://bugs.launchpad.net/bugs/1395533

Title:
  Kit Wizard Description needs to be simplified.

Status in “qtcreator-plugin-ubuntu” package in Ubuntu:
  New

Bug description:
  http://i.imgur.com/XJrEDhD.png 
  Just to preface; I am not the only one who had issues with this. 

  The problem:
  After reading this, I still have no idea what "Kits" are exactly for, and I do not know intuitively what architecture I am supposed to be choosing. "Kits" are too vague, and need to be more explicit. "Packaging Kit" seems more apt.

  For example:
  "In order to create apps for the ubuntu platform, it is required to create kits"
  - This is vague, and not true in the literal sense. For example; I was creating apps for ubuntu before these "Kits" came along.
  - The question that comes into mind is, "Is this for packaging? I have no clue because it does not say so". 

  "Kits enable cross platform and cross configuration development"
  - I have no idea what "Cross Configuration Development" refers to, at least not intuitively. 
  - I have no idea what the scope of "Cross Platform" means. Does that mean I can develop software on other platforms like mac or windows, or that I can develop for other architectures? 

  
  "Kits consist of a set of values that define one environment, such as a target device, sysroot to build against, toolchain to build with, platform specific api set, and some metadata."

  - These need to be bullet pointed.
  - These are perhaps a bit too technical on there own. Not everyone is familiar with "Sysroots", nor why it is important to "Build against" them, nor what the "Toolchain" references, nor what the "Platform specific API" you are talking about is, nor what specific metadata we are talking about is. 

  In short; 
  This explanation fails to tell me "Why I need this", and "What it does" in the most simple and down to earth terms.

  If I need a kit to create a package, then call it "Packaging kits",
  and say "Packaging kits are used to install the program on a system.
  You need one for every architecture you plan to release the software
  for."

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/qtcreator-plugin-ubuntu/+bug/1395533/+subscriptions