Re: [Discuss-gnuradio] PyBOMBS documentation recommendations

[HansFong]

Adding to this, please always add a revision date to any documentation, 
preferably at the top. It is so difficult to guess if documentation is 
current or not. Thank you --Hans (BX2ABT)

On 11/8/19 11:12 AM, Barry Duggan wrote:
> Greetings,
>
> I have found four URLs giving instructions on using PyBOMBS:
> <pre>
> https://wiki.gnuradio.org/index.php/InstallingGR#Using_PyBOMBS
> https://github.com/gnuradio/pybombs/README.md
> https://github.com/gnuradio/gnuradio/README.md
> https://www.gnuradio.org/blog/2016-06-19-pybombs-the-what-the-how-and-the-why/ 
>
> </pre>
>
> In various comments in Discuss-gnuradio, I have concluded that most of 
> the PyBOMBS users who have failed were due to using old or incomplete 
> instructions. Also I think that most new users read the 
> InstallingGR#Using_PyBOMBS instructions only.
>
> As an advocate of having a single place to document instructions, I 
> highly recommend picking one site for those instructions, and then 
> having links to that page from all others. From what I see, the 
> https://github.com/gnuradio/pybombs/README.md page seems to be the 
> logical choice since it is revised as PyBOMBS is revised.
>
> If you choose to have the 
> https://wiki.gnuradio.org/index.php/InstallingGR#Using_PyBOMBS page 
> contain the current instructions as well, I can convert the 
> pybombs/README.md instructions to Mediawiki and put them in 
> InstallingGR#Using_PyBOMBS.
>
> Once you have decided what you want done, I can take care of the 
> edits, if you would like.
>
> Best regards,