Literate Programming with markdown
I’m returning to my Ottoman language project time to time and most of the time I spend is actually trying to understand what I have done last time. I decided that the actual parsing and simple morphological analysis modules should use Literate Programming with markdown.
I’m currently using Dart to rewrite all the application and the application is fundamentally simple. It receives words in Turkish or Ottoman and translates these to Ottoman or Turkish. However the parsing module needs more rules to divide the words (and phrases) into roots and suffixes. There are hundreds of rules and using just code to describe the reasoning behind parsing seems the main culprit I spend my time to understand my work.
I decided that I can just use knot to write the rules in a document and generate the files by this. It will surely take more time than writing the code but at the end I will have a document describing the analysis and parsing rules that even I can understand.