-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 7/12/2013 10:29 AM, Kent Reed wrote: > On Fri, Jul 12, 2013 at 10:46 AM, Michael Haberler > <[email protected]>wrote: > >> <...> RFP: I suggest we switch all build/install documentation of >> any kind to in-repository documentation (manual) proper, the Wiki >> method is just asking for trouble with outdated information >> > I strongly support this proposal. I spent time trying to clean up > some of the Wiki pages on build/install after the rebranding and > found them to be a messy plate of spaghetti that was in effect > unmanageable. Creating more formal documentation is a pain but I > believe over the long haul it's a more manageable pain. > > We aren't alone in this dilemma. Anyone who tries to follow Linux > on ARM developments in general and BeagleBone developments in > particular knows the confusing documentation landscape painted by > the various blogs, wikis, forums, and READMEs.
Yes, and it should be noted that the number of problems due to documentation and support issues for the BeagleBone exploded after the Black was released due not only to the major changes to the hardware but also to the major structural changes on the software side caused by switching to the 3.8 kernel. IMHO, the new RTOS and unified build code represents a similar split for LinuxCNC, where a lot of existing documentation could be misleading or just plain wrong. There should be a well marked location to find the current documentation, and a clear indication that anything *NOT* found in the official location(s) is potentially outdated and wrong. - -- Charles Steinkuehler [email protected] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (MingW32) Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iEYEARECAAYFAlHgJSgACgkQLywbqEHdNFyIDQCfcYG30+4BDtFIG6j2mWHzIG7e g1sAoPsdm/U3+XtSX0xF7NnXVlWE4c+F =9yvH -----END PGP SIGNATURE----- ------------------------------------------------------------------------------ See everything from the browser to the database with AppDynamics Get end-to-end visibility with application monitoring from AppDynamics Isolate bottlenecks and diagnose root cause in seconds. Start your free trial of AppDynamics Pro today! http://pubads.g.doubleclick.net/gampad/clk?id=48808831&iu=/4140/ostg.clktrk _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
