Sheila Mooney wrote:
Once again, I am tasked with updating these files for Preview. I wanted to see if people thought we should simply keep this brief (like we have before) or consider adding more content in this file ie: description of product features and perhaps copying some content from the landing page in case people don't have internet access and can't get at the link. If we were to provide more info, what else should we consider putting in this file?
I vote to keep it real short as we did in the past. All a README should have is info to bootstrap a user from a downloaded bundle to a running app. i.e., how to install and how to run first time. Having pointers for more info (to the site) is good. Avoiding duplicating info will avoid inconsistency and production headaches. The only thing I would add is a reminder to open the Relnote file for futher last minute information (known bugs mostly) and a pointer to the license file.
Cheers, - Philippe _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ Open Source Applications Foundation "chandler-dev" mailing list http://lists.osafoundation.org/mailman/listinfo/chandler-dev
