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