Re: [Discuss-gnuradio] GNU Radio website.

[Eric Blossom]

On Sat, Mar 03, 2007 at 12:54:31PM +0100, Trond Danielsen wrote:
> Hi everyone,
> 
> I've been looking at the GNU Radio websites, and feel that there are
> some improvements that could be made. The website at gnu.org looks
> good, but lack up to date information, and the trac website has up to
> date information, but could use some polishing. I was therefore
> thinking of starting to clean up some of the pages in the wiki,
> starting with the front page. I have created a new frontpage that is a
> lot simpler than the previous one; I did not want to commit it
> directly, since it is the public face of gnuradio, so let me think
> what you think.
> 
> I am aware of that there are some scripts to convert the old wiki
> pages to trac format, but that is not what I am thinking of now.
> 
> Cheers,
> -- 
> Trond Danielsen

Hi Trond, thanks for your work on the Wiki and everything else!

If we use this as the front page, how are people going to:

  Figure out how to download the code
  Figure out how to build GNU Radio

I agree that the current WikiStart page isn't beautiful, however it
does handle what I assume are the first 95% of the questions: where's
the code, how do I build it, and what about the USRP stuff?

I'm also a bit concerned about pages that provide almost no real
information, just a set of sublinks, particularly if they're in my
way of getting to what I want ;)


Also, as a general design principle, I like to minimize the number of
places where information is replicated.  If the info is in more than
one place, you can pretty much count on at least one of them being out
of date.  The reentering of the mailing list stuff comes to mind: once
on www.gnu.org and once on gnuradio.org.  In this case, I should
probably edit the referring pages on www.gnu.org to point at the wiki
pages. 

I also realize that we still have some useful stuff in the old
comsec.com wiki.  Martin and I have recently done some work on the
conversion tool, and will eventually get the good stuff moved into
trac, then shutdown the the old one.


Eric




> = Welcome to GNU Radio! =
> 
> == Introduction ==
> 
> GNU Radio is a collection of software that when combined with minimal 
> hardware, allows the construction of radios where the actual waveforms 
> transmitted and received are defined by software. What this means is that it 
> turns the digital modulation schemes used in today's high performance 
> wireless devices into software problems. 
> 
> 
> == Content ==
> 
>  * '''[wiki:BuildGuide Getting started]'''
>  * '''[wiki:MailingLists Mailing lists]'''
>  * '''Documentation'''
>    * [http://gnuradio.org/doc/doxygen/hierarchy.html Doxygen generated API]
>    * [wiki:SuggestedReading Suggested Reading]
>    * [wiki:USRP Universal Software Radio Peripheral]
>  * '''[wiki:OurUsers Real world users]'''
>  * '''[wiki:AcademicPapers Academic papers involving GNU Radio]'''
>  * '''[wiki:Support Commersial support and training]'''
>  * '''[wiki:Development Contribute to GNU Radio]'''
> 
> 
> == News ==
> {{{
> #!comment
> No more than 5 entries
> }}}
> === March 1, 2007 - GNU Radio 3.0.3 release ===
> This is a bug fix release. For a complete list of changes see the 
> log:gnuradio/branches/releases/3.0. To download the code, please see 
> BuildGuide.