<div>I have a couple questions about how PLaneT packages with scribbled documentation will work.  I guess most of these are for Jacob, but I welcome input/opinions from anyone.</div> <div> </div> <div>1. Will there be some backward compatible mechanism so that new (or updated) PLaneT packages with scribbled documentation can be loaded in older PLT Scheme instances?  Specifically, what will happen when someone is running V370 (or V360, whenever the cutover is/was) and requires a PLaneT packages with scribbled documentation?  Will it warn about the scribblings entry in info.ss, quietly ignore it (and not load the documentation), or something else?</div> <div> </div> <div>2. Will there be a new PLaneT repository for post-scribble PLaneT packages - similar to the 2xx/3xx split now?</div> <div> </div> <div>3. If we have examples in a PLaneT package that refer to that package itself, will this be loaded properly?  That is, can an example in the scribbled documentation within a PLaneT package that contains a require for that package be run within scribble to produce the output?  Alternatively, will the documentation have to be static and contain the expected results - the way we (or at least I) do it now? </div> <div> </div> <div>4. Should we avoid even trying to upgrade to scribble for released packages for now?  Or, is there a safer way to start with scribbled documentation?  For example, can we develop scribbled documentation, generate the HTML, and manually add it to the package before creating the .plt file? </div> <div> </div> <div>5. Are there any PLaneT packages currently using scribbled documentation we can look at for guidance?</div> <div> </div> <div>6. Have the PLT guys thought about any 'standards' for developing the scribbled documentation?</div> <div> </div> <div>7. Are there any plans to have PLaneT automatically generate a pdf file for those who want better hardcopy documentation?</div> <div> </div> <div>I'm sure I'll come up with others as I dig into it more.</div> <div> </div> <div>Doug</div>