|
Upgrading Sigil
I have been browsing through the sigil code and see the major problem with sigil naintenance. NO PROPER DOCEMENTATION!!!
Unless the programmer thinks, eats, breathes, and dreams in C++, understanding what is going on is very difficult and not being totaly knowledgeable in the general functioning (epub operations) maintaining the code will be a huge learning curve.
Each modile should be accompanied by a pseudo code file defining and demonstrating the desired inputs, outputs, and data manipulation to be performed. The US military tried to overcome these problems with ADA, even then with limited success. Pseudo code is written to be understood by humans whereas code is written to be understood by machines.
IF the folks who have brought Ssigil to this point can be convinced to create this information, Sigil becomes eminently maintainable and can be easily expanded.
|