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