The Following 9 Users Say Thank You to rotoflex For This Useful Post: | ||
![]() |
2012-02-16
, 18:12
|
|
Posts: 1,455 |
Thanked: 3,309 times |
Joined on Dec 2009
@ Rochester, NY
|
#2
|
![]() |
2012-02-17
, 11:55
|
Posts: 1,808 |
Thanked: 4,272 times |
Joined on Feb 2011
@ Germany
|
#3
|
The Following User Says Thank You to reinob For This Useful Post: | ||
![]() |
2012-02-25
, 11:11
|
|
Posts: 381 |
Thanked: 336 times |
Joined on Jan 2011
@ Stockholm, Sweden
|
#4
|
![]() |
2012-02-25
, 16:47
|
Posts: 1,326 |
Thanked: 1,524 times |
Joined on Mar 2010
|
#5
|
I have been a C programmer for years, but just trying to start in ANY way to get something going writing for the N900, setup information gets more & more fragmented, abstruse, inaccurate, superseded but not corrected, massively time-consuming, & ultimately not worth it. You can waste DAYS just trying to bore down to find out what software you need for development, then trying to download it.
Today's example: after churning for an hour on alternately superficial then lengthy, needlessly detailed pages, an attempt was made to download Scratchbox, being led there via a link from who knows where. We get to:
http://www.scratchbox.org/documentat...oc.html#AEN132
updated /etc/apt/sources.list as directed, then on apt-get update in root terminal got:
Failed to fetch http://scratchbox.org/debian/./Packages.gz 404 Not Found
This is insane.
It comes after hours of sifting through Google Search, & endless branches into links to easter egg hunts on http://www.developer.nokia.com/Resou...s/Other/Maemo/, http://www.developer.nokia.com/info/...emo_5_SDK.html, http://wiki.maemo.org/Documentation/...K_Installation, http://www.scratchbox.org/download/scratchbox-hathor/, http://www.scratchbox.org/documentat...oc.html#AEN132
Only somebody with luck or who is paid by the hour to pursue this would continue.
The Wiki model is useless for conveying beginning developer information. It contains old, outdated information that casual users cannot know is old & outdated, for purposes of use OR maintaining the information.
And it is ALL written, from the Wiki to corporate/project information pages not in the algorithmic form a user requires, but in the sling-it-all-in-the-junk-drawer departures that the DEVELOPERS OF THE SDK's must work in and use.
Someone who wants to install an SDK wants this information:
HOW TO INSTALL ON I386 DEBIAN-BASED BOX -> do A, do B, do C, etc.
HOW TO INSTALL ON I386 WINDOWS MACHINE -> do A, do B, do C, etc.
HOW TO INSTALL ON TIMEX SINCLAIR -> do A, do B, do C, etc.
This is how it is done instead:
TO INSTALL: do A if on a Debian based box, unless using a 64-bit machine in which case do B, Windows users will need to do C first then do B, next do B (except for 64-bit Debian based boxes), and do D for Windows 16-bit machines, do not do any of the above if E has not already been installed on any Linux machine, or all will need to be re-installed. If E has been installed, before installation of A it will be necessary to reconfigure E by downloading F and making the following changes in its configuration file....
It's insane. Creators of installation packages must think that way to create branching accommodations for various needs, but they are not the way algorithmic instructions need to be presented.
The Wiki approach just layers more hands on a self-obfuscating mess, and TMO posts, being of lengthy time frames & of unending pages of discussion & drama with accurate information for any given point in time sprinkled thinly through it & the current, accurate points indistinguishable from superseded & erroneous information, are not practical for final presentations of information.
I would like to propose that in the Developer talk section, someone create a post for setting up Development on particular system, with information presented algorithmically & not branching into other systems, the moderator sticky the post, & then the OP maintains that post. If in the event the OP disappears, the moderator should ask for someone else to maintain the post, & that person should copy & paste the previous post to a new post which will be stickied & maintained while the original sinks.
Discussion in the thread would be about error-correction & elucidation, & could all be ignored by someone looking for the information in the first post.