On Fri, Apr 23, 2010 at 01:18:01AM -0700, Yioryos Asprobounitis wrote: Cool. Looks like quite a bit of invested time required if anyone wants to use this ... I suggest you always include the steps to use in a release, rather than referring to steps in a previous release. No plans that I'm aware of. -- James Cameron http://quozl.linux.org.au/

On Sun, Apr 25, 2010 at 10:08:09PM -0700, Yioryos Asprobounitis wrote: Your documentation was not easily used. It was complex and difficult. You mean the filesystem label, not the stick label? It was unclear from the instructions. I'll review your instructions for you, so that you can improve them. Your announcement in this thread pointed me to http://ftp.cc.uoc.gr/mirrors/linux/TinyCore_for_XO1/Announce%20tc-xo_02%2... Suggestions: 1. shorten the URL, since it is somewhat long and doesn't fit into a typical 80-column window, 2. remove unnecessary spaces, since they make it harder to convey, Next step is reviewing the content. The announcement didn't include an "Installing" or "Using" section, it only included a "ChangeLog", "About", and "Known Issues". In the "About" section it referred the reader to a previous announcement. Suggestions: 3. add a section in the content that explains how to use what you have built, "Install" or "Installation", 4. don't refer outside the document unless there's a good reason to do so; it makes installing harder if multiple documents must be accessed, 5. make sure changes are kept inside the change log section (e.g. the mention of Opera should go there rather than in "About"), 6. use HTML or a markup language that doesn't require sideways scrolling; in viewing your .txt file in Firefox the horizontal scrollbar was needed, and it was very hard to read the lines because they were not wrapped early, Next step is reviewing the content that was referred to ... which is file http://ftp.cc.uoc.gr/mirrors/linux/TinyCore_for_XO1/Announce%20tc-xo_01%2... but I could not tell what part of that file was now incorrect for your version 02. I presumed I only had to look at the "Installation" section ... Suggestions: 7. explain where the "build_script" folder is, and what "build you own" means in the context of "Installation", 8. explain how to change the label of an ext2 filesystem on a USB stick; tune2fs -L perhaps? And can you explain *here* (not there) what it is about dd that makes you think it damages media? -- James Cameron http://quozl.linux.org.au/

On Mon, Apr 26, 2010 at 07:14:25AM -0700, Yioryos Asprobounitis wrote: Much better. Some suggestions attached. I've not fully tested these suggestions, but I think they should work. Consider them for your next release. I also suggest moving the installation instructions to the start of the page, just before "About the build". Surely you can find a better hosting service, where you can choose the names. ;-) If not, at least look at tinyurl.com or equivalent services. This is not true where dd is being used on the partition level. Writing a 64Mb ext2 filesystem image to the first partition of a 1GB USB stick, for instance, does not change the factory optimized partitioning. -- James Cameron http://quozl.linux.org.au/