| From: David Farning <[EMAIL PROTECTED]>

| Below is a very rough outline-brain dump- of what I think a user needs
| to know before installing a pre-built image.

Tough problem -- what can you assume the reader knows?

I guess that the first thing to state is what you do assume that they
know.

|  Installation recipies
| are *bullshit*.  

Why do you say that?  I can think of reasons, but I don't know if they
are yours.

I think that recipes are brittle: if any of the ground shifts, the
user gets loss.  Without the right tools, they can only recover in spite
of a recipe.

| All of the sections needs to be fleshed out(I expect the chapter to end up
| being about 40-50 pages long) .

That is an awfully long chapter.  Maybe subsections will be sufficiently
bite-sized to make the document easy enough to absorb.

|  I would appricate
| suggestions on key stuff that I am missing.

I read what you wrote.  I am surely not be the target audience, but it
didn't give me much of value.

I wonder whether the generality of the set of targets make it hard to
say specific things and the specific is the easiest to understand.


| The chapter will have two goals.
| 1  The reader should have enough knowledge to an image on their device.
| 2  The reader should be able to find and refer to other embedded
| device books.

I would think that (1) might be best separated from and preceded by 
explaining (0) how a OpenWrt system fits together.
_______________________________________________
openwrt-devel mailing list
openwrt-devel@lists.openwrt.org
http://lists.openwrt.org/cgi-bin/mailman/listinfo/openwrt-devel

Reply via email to