On Wed, Oct 27, 2010 at 8:38 AM, Simon Laws <[email protected]> wrote:
> The question now comes about what to do with it and what to do with > the READMEs that are currently checked into svn. For example, do we... > > 1. - Just provide it on the website or do we ship it in the distro as well > 2. - Present it as separate pages or split it into sample specific pages > 3. - Remove the existing READMEs in lieu of the new web page > information or maintain the READMES in some way. > > In the long run my answers would be > 1 - both site and distro +1, though I have questions on how these would be maintained. If we add a new sample in a release, does it get added to the existing web page? Or will there be a new page for each individual release? With the former, things can easily get out of synch and thus become confusing for users. With the latter it becomes more difficult to maintain. Neither seems like a major issue, though. > 2 - split it into top level page and sub htmls for samples if possible +1 > 3 - remove the READMEs and rely on the html +1 assuming there is still a top level README that gives a brief overview and points to the HTML. > > For the coming release I think I would just stick with it up on the > web site and remove the local READMEs. We can then review what we > think. +1 Brent
