Hi Harald, I don't mind updating the wiki where I see errors at all - as long as I'm not stepping on someone else's feet by doing so.
A couple of spots that I feel need some updating are: 1) http://wiki.openmoko.org/wiki/OpenEmbedded ==> This page needs a bit of an overhaul, IMHO, and as this is a fairly important tag or buzz-word, where a lot of traffic is generated, people need to see the right instructions here to get moving - quickly. However, because OpenEmbedded and BitBake are so closely related, maybe it would be a good idea to redirect BitBake to OpenEmbedded, and to have a separate page for BitBake Recipes, documenting how to leverage OpenMoko / FSO's existing classes and recipes for compatibility. I don't have any experience with the application layer personally, so I would ask someone else to do the BitBake Recipes page. ==> If people should not be synchronizing with Git.OpenMoko.Org then maybe it's time to remove the reference on this page. If people are interested in page history, the wiki actually keeps previous versions, but I would suggest putting this reference into more of an 'Archives' page somewhere else. ==> @ Rod : What is the current status of MokoMakefile ? Does it take into account the changes in the preferred repository? I really do think that MokoMakefile is an important part of the process. This is particularly true for application-level developers as opposed to system-level developers, so I would vote to keep this. I would suggest putting a reference to MokoMakefile right at the top of the OpenEmbedded page, to more or less incite developers to use MokoMakefile first before delving into OpenEmbedded. 2) http://wiki.openmoko.org/wiki/BitBake ==> This is the page that actually confused me at first. ==> Is it necessary to use OpenMoko's version of bitbake still ? ==> The section 'get openembedded tree' is wrong and needs to be updated - I beg the person responsible for this page to consider referring to a single, cenralized page like http://wiki.openmoko.org/wiki/OpenEmbedded . It's not a good idea to have condradicting OpenEmbedded instructions on the same site. It's probably a good idea to have OpenEmbedded instructions that are aligned with MokoMakefile, so that directory structures and the like are similar - including naming of development overlays. If nobody disagrees with my suggestions, then I will go ahead and rewrite a portion of the Wiki ... I realize that sometimes it's impossible to keep track of all of the pages that one writes - myself included - the Android page as an example, I'm no longer actively working on Android with the FreeRunner, and I should probably ask someone else maintain it ... Can someone else please maintain the Android page on the OpenMoko Wiki ? Sean ? Maybe Bricode ? Cheers, Chris On Tue, Feb 3, 2009 at 2:35 AM, Harald Welte <[email protected]> wrote: > To Everyone: > > On Sat, Jan 31, 2009 at 01:17:16PM -0500, Christopher Friedt wrote: > >> Originally I was following the Developer's Guide on the OpenMoko >> Wiki... it seems to be a bit outdated because it still suggests to >> synchronize with git.openmoko.org. > > It's a real PITA to see that the wiki basically doesn't get this kind of > important update. There once was a time (and this has actually been confirmed > to me recently by a number of people) where developers working for Openmoko > actually updated the wiki with everything they did. > > So if somebody decides that git.openmoko.org is no longer used but instead > upstream OE, then whoever makes that decision: Please update the wiki to > reflect that change. > > It is a terrible waste of developers time if they spend time with trivialities > like this, rather than working on actual development or bugfixing. > >> Apparently we're all in the same boat - who has time to update documentation >> !? > > I'm not expecting anyone to write lengthy novels. But updating a single git > server address in the wiki? 30seconds, max. > > -- > - Harald Welte <[email protected]> http://openmoko.org/ > ============================================================================ > Software for the world's first truly open Free Software mobile phone > _______________________________________________ devel mailing list [email protected] https://lists.openmoko.org/mailman/listinfo/devel
