Hello,

I would like to support what Bill wrote:

> The natural approach to this is to have the manuals sources as part of 
> the product sources, that way they can be branched, merged and, tagged 
> automatically in line with the product.

Exactly. Everything that's in relationship with the code such as documentation 
and unit tests should be a part of the branch.

> Having said that manuals do present a special problem with source control
> merging since they tend to be bulk updated and do not merge very easily.

This is true and it actually depends on the documentation source format.

> Also incorporating the manual sources into the product sources means 
> that the manual build steps need to be added to the product build scripts.

Of course.

By the way, speaking about unit testing... I am new in the WSJT field and I 
wanted to understand the internal principles. So I reimplemented the whole 
coding path from the message like "CQ OK2TKB JN89" up to the 50 second WAV file 
in Python. During that work I prepared many unit tests using Python's unittest 
module. Then, when something didn't work I also wrote Fortran proxies to make 
individual Fortran coding steps available at Python level too.

Actually there are many smart ideas incorporated in the protocol (mainly the 
synchronization using the pseudorandom pattern and the Reed-Solomon FEC) that 
it was a very nice lesson to me.

I would like to thank Joe Taylor very much for a nicely designed and well 
working communication protocol.

Tomáš
OK2TKB
------------------------------------------------------------------------------
BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
Develop your own process in accordance with the BPMN 2 standard
Learn Process modeling best practices with Bonita BPM through live exercises
http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_
source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
_______________________________________________
wsjt-devel mailing list
wsjt-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/wsjt-devel

Reply via email to