Repeat: documentation
Posted: 1 Nov 2013 13:18
I'm not a pro programmer, but I can use VP for occational easy apps, like CRUD with nice guis.
But: scrolling through the PFC, I find it daunting, and there are no comments. A few years ago, I needed to use an SQL server database. I bought a book, "Inside ODBC," where everything was thorougly explained, and to my joy, the PFC Odbc classes turned out to be wrappers using the same terminology.
The other day, however, I tried to understand the XMLlite classes in the PFC. I tried to compare the predicate names, data types, etc. with the terminology used in XML DOM, XMLQuery, Xpath, which I'm familiar with, but instead the PFC seems to implement some specific Microsoft API, the MSXML, which even needs to use the COM-package to work. That's really very different from javaScript
Well, anyway.....
Back in 2007 I suggested to establish the Wiki, specifically for users to document PFC packages of special interest to them, so that also the rest of us could reap the fruits.
The PFC contains 52 directories. Some of them are well documented, like GUI, String, and several others. But some of the cryptical ones are quite obscure (to me, at least) and could need some explanation.
So, now I expect a rush of knowledgeable people rushing to write a few paragraphs about their favorite obscure PFC classes to the Wiki
But: scrolling through the PFC, I find it daunting, and there are no comments. A few years ago, I needed to use an SQL server database. I bought a book, "Inside ODBC," where everything was thorougly explained, and to my joy, the PFC Odbc classes turned out to be wrappers using the same terminology.
The other day, however, I tried to understand the XMLlite classes in the PFC. I tried to compare the predicate names, data types, etc. with the terminology used in XML DOM, XMLQuery, Xpath, which I'm familiar with, but instead the PFC seems to implement some specific Microsoft API, the MSXML, which even needs to use the COM-package to work. That's really very different from javaScript
Well, anyway.....
Back in 2007 I suggested to establish the Wiki, specifically for users to document PFC packages of special interest to them, so that also the rest of us could reap the fruits.
The PFC contains 52 directories. Some of them are well documented, like GUI, String, and several others. But some of the cryptical ones are quite obscure (to me, at least) and could need some explanation.
So, now I expect a rush of knowledgeable people rushing to write a few paragraphs about their favorite obscure PFC classes to the Wiki