On Sat, Sep 08, 2007 at 11:11:45PM +0200, Felix Fietkau wrote: > David Farning wrote: > > One of the reasons the current documentation is confusing and > > disorganized is that specific users of the information have not been > > identified. For example: > Actually the new (and pretty much incomplete) documentation was structured > with > almost the exact same structure in mind that you're giving here: > > > -Basic End-users just want to install a new firmware with few > > surprises. > Chapter 1.1. Getting started > Chapter 1.2. Configuring OpenWrt > > > -Advanced End-users are willing to work for advanced functionality but > > don't to write code. > Chapter 1.3. Advanced configuration > > > -Application developers want to know how to write applications and > > package them for OpenWrt. > Chapter 2.1 The build system > Chapter 2.2 Extra tools > > > -Kernel hackers want to be able to efficiently port OpenWrt to > > additional platforms. > > -Tool chain developers who assemble the tools necessary to make the > > various parts fit together. > Chapter 2.3 Adding platform support > > > It looks like a lot of the frustration over the past couple of months > > has been caused by these users rubbing each other the wrong way. In > > the immortal words of kernel hackers everywhere, “I don't do user > > space.” How may users care how a the memory manager works? > > > > I would like to propose that we start to refactor the existing > > documentation according to the needs of the above groups. (Yes, I am > > volunteering to do the work.) > We want the main source of documentation to be the LaTeX tree that is being > maintained in SVN. Please let me know if the structure that I mentioned above > is > suitable for your needs. > > Thanks for your interest, > > - Felix
Nice, it looks like the new document is heading the right way. But I do belive that you guys have been working with routers too long if you think a newbies can figure out how to mess with config files;) Getting started should probably involve telling the user how to install an ipkg gui. I really like how you have refused to allow any sort of web interface to be shoehorned in the OpenWrt core. The config tools should sit on top in userspace. Please take a look at the OpenMoko.org to see how they have structured things. I would be willing to start structuring the OpenWrt Wiki in a similar manner and keep it organized. The end goal of writing a Latex doc sounds good. But not something I am willing to commit to yet. thanks David _______________________________________________ openwrt-devel mailing list openwrt-devel@lists.openwrt.org http://lists.openwrt.org/cgi-bin/mailman/listinfo/openwrt-devel
