Hi! Noah Lavine <[email protected]> skribis:
> Hello, > >> The problem is that the auto-generated “Standard Library” section looks >> very poor in comparison to the rest of the manual. So we should really >> try hard to write good doc by hands for these, and come up with a handy >> structure (instead of one node per module, all under “Standard >> Library”). > > I could do that pretty easily, but I'm afraid that documentation that > isn't in the same file as the code would tend to be updated less often > than documentation in the same file. All of our manual except “Standard Library” is maintained this way. It takes discipline to keep up-to-date, but it also leads to a better manual IMO. >> However, I believe Thien-Thi’s Guile 1.4 has good doc for at least some >> of these modules, and it would be great if it could be incorporated. >> >> WDYT? > > That would be ideal, but I was concerned that the documentation wasn't > copyrighted by the FSF. Unless Thien-Thi is interested in contributing > it, of course. Yes, I was hoping he would be reading us, let’s see. ;-) Thanks, Ludo’.
