Mailing List Archive: 49091 messages
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search

[REBOL] Re: Comments about make-doc-pro?

From: dness:home at: 8-Aug-2001 22:34

Robert M. Muench wrote:
> Hi, I hope that some of you had a look at the make-doc-pro script and played > around with it a bit. Any comments? Robert >
I have several. Please read them in light of the fact that I know a fair amount about computing stuff in general, but not very much about REBOL in particular. I like the topic and the implementation. However, there are some things which are either mis-understanding on my part (and thus might point to more documentation) or things I think you might conider changing. Reading the code is fine, for documentation, but it doesn't give sufficient overview to actually make the process useful. If you are not intending to supply further information, I'd make it more extensive. Also, I find it somewhat disconcerting that running your test text creates a live display that starts with `Heading 2' as though something had been forgotten. I'd make the test both more productive and more descriptive. And while I understand using DE for German, I wonder if EN might not be more reasonable than US, although I suppose this could be some REBOL `standard' that I don't know enough to understand yet. I don't get the role of `display' that automatically pops up in the browser, and whatever happens to %index.html. It also strikes me as a _very bad_ idea to destroy my index.html without so much as a by-your-leave, why would I expect your code to do that? In most circumstances I want to be able to do something with the HTML that results from the translation, so I would much prefer that this be written into a file than that it appear `live'. I assume you are probably familiar with `similar' attempts to deal with this problem. One of the better ones, IMO, is Todd Coram's `AFT' (Almost Free Text, which he did with some help from Ward Cunningham of Wiki and Extreme Programming fame). It is at and I would suggest you look carefully at it if you haven't alread done so. He implements many of the facilities you have implemented, as well as some that are on your `future' list. I am writing a paper comparing some of this class of facility for some clients. When I have finished it, I will seek their permission to `publish' it, and will put it on my web site if that is forthcoming. I think you have taken something that was useful, and made it even better. I look forward to further developments...