Re: hand book idea

On 01/15/14 17:49, Jon Rocker wrote:
> At my former job I had written up some documentation on wireless.
> Wireless Theory, for example. I'd be happy to share my documents with
> you, if you'd like
>
> Jonathan Rocker


Hello Jonathan,

Folks tend to dislike top posting, if you can avoid that. I believe that 
most docs are moving to the wiki.gentoo.org site, so if you like, just 
post your offering there with a note  inviting others to "chime in" on 
making it better and more useful.


One basic principle that I think would help our (gentoo) documentation
is to employ some sort of document hierarchy scheme, with the
various layers being either hyper-linked to other documents, or
expanded/contracted in a consistent (enfored?) semantic. The exact 
mechanism(s) employed sould depend on what the folks that oversee the 
wiki belief is a solid, consistent semantic. I am not qualified to get
deeply involved in those semantics, except as a consumer of the
resource. Personally, I'm more of a hardware guy, who stands tall
on the genius of the good software minded folks of gentoo.......


So my philosophy for the new gentoo wiki, would be to keep only the
most essential (stripped?) information at the highest level visible,
yet the details, theory and options are a click (or 2) away in
some form of "expanded/hyper-linked" view. With that in mind, 
post/edit/add your offering on wiki.gentoo.org and drop us a line.....?


Also, remember, gentoo is a very classy organization, where sincerity 
and honesty are paramount. We each have knowledge that may be sensitive 
to former employers and/or clients; so please do not offer up anything 
that is the "bonafide" Intellectual Property of others, as a general 
guideline.


hth,
James