Irwin en parte concuerdo con lo que dices.
kodnet en particular fue un proyecto que hice hace unos 6 años (cuando tenía 19). Si lo hubiera hecho ahora que he madurado un poco en mi visión y mi oficio como programador, seguro habría mejorado varios aspectos técnicos del código y documentación. Lo liberé hace poco porque estoy queriendo sacar todas las herramientas que había hecho en el pasado para VFP
Lo de la lentitud es lo de menos, estoy seguro que puedo lograr que el parser sea más rápido que el motor actual de VisualFoxPro. Y estoy seguro de eso porque VisualFoxPro como intérprete es "muy lento" en comparación a otras plataformas (basta con crearte un ejemplo sencillo: una funcion que sume dos números, haz la prueba contando cuanto tarda en ejecutarla 1 millón de veces, para darte una idea, en una máquina que tengo, en VFP tarda 1,554 segundos en el motor V8 de javascript tarda en un código equivalente a eso 0,006 segundos ), y yo mismo hace unos 6 años igualmente (poco después de lo que ahora se llama kodnet), ya me había hecho un parser del lenguaje, con las funciones internas, escribiendo el parser, el intérprete y las funciones base (exceptuando las de DBF aún no llegaba a esa parte, aunque había puesto en cambio SQLite embebido) completamente en C#. Y bien recuerdo que logré hacer que corriera muy por encima de lo que corre VisualFoxPro. En ese tiempo no era tan ordenado con mi código terminé PERDIENDO casi todo ese código, pero recuerdo que me sirvió mucho para afianzar mis conocimientos en programación y algo de eso lo iba a aplicar en kodnet pero nunca terminé haciendolo (eso le hubiera dado aún más velocidad al proyecto de kodnet, ya que se aplicaba compilación JUST-IN-TIME con el manejo de System.Reflection.Emit de .NET)
Y volviendo a kodnet, entiendo lo que me dices, pero siento que en sí kodnet no necesita mucha documentación, tal vez ejemplos. Traté de incluir varios ejemplos en el proyecto que sirvan de base. De todas maneras para usar kodnet se necesita más que todo saber de .NET Framework
También ahora de manera específica digo que si alguien quiere aplicar kodnet para algo en específico pero no entiende mucho del .NET Framework o no encuentra como puede hacerlo, yo puedo trabajar en ello, y eso me serviría para seguir encontrando cosas por mejorar en la librería.
SIn embargo tú como usuario Irwin, que más esperarías que haya en la documentación? Has visto los ejemplos? QUé otros ejemplos serían útiles?