On Thu, Sep 30, 2010 at 09:42:27AM +0300, Amit Kucheria wrote:
On Thu, Sep 30, 2010 at 3:10 AM, Christian Robottom Reis kiko@linaro.org wrote:
On Wed, Sep 29, 2010 at 11:07:27AM -0400, Scott Bambrough wrote:
This script should ask some basic questions and just do the right thing. This should be a separate script from linaro-media-create.
I'm not sure this problem is actually that big. I mean, I expect as a community developer I'm either interested in the latest release, the latest development milestone, or a nightly, and those are just 3 links to directories -- you there choose the image type, and pull in the right hardware pack.
The problem, IMO, is that these are scattered all over the place and there are too many variations as we add new support. So the documentation will always be out of date.
[snip]
You make some good points and if we are failing at documenting the procedure to actually install our images then thats bad and should be fixed ASAP. There are a couple of problems here:
* We are adding support for more hardware and failing to keep up with documentation. * Some hardware may need special tweaks or installation instructions, this knowledge is usually with the engineer(s) who are enabling the board. It would be better if they contributed to the wiki pages as well outlining any extra steps needed, special test cases e.t.c. * Some boards are partially supported. You gave an example of iMX. This is a good example of a board that was requested to be supported, has pending changes in the media-create script and no one responsible for iMX has stepped up to document the test-cases or installation instructions yet. * You mentioned VExpress and OMAP as the only supported platforms really documented at the moment. That was our goal at the start of the cycle, to enable these two platforms. The fact that other platforms are starting to come online is great but again, the documentation is lagging behind.
As a stop-gap I will go through the wiki pages today that deal with board support and installation. I'll produce a top-level page which will link off to the various platform specific instructions and documentation so at least we will have one link to navigate from.
The discussion about whether we need a wrapper tool, which will need to be update for each board (very much like the wiki I suppose), is another topic.
Regards, Amit
Regards, Jamie.