@@ -5,16 +5,26 @@ @; Copying and distribution of this file, with or without modification, @; are permitted in any medium without royalty provided the copyright @; notice and this notice are preserved. This file is offered as-is, @; without any warranty. -@title{Local Yarn Codebase} +@; Scribble source for the main page of the code documents. + +@title{Local Yarn: source code notes} @author{Joel Dueck} -These are my notes about the internals of the Local Yarn source code. I wrote them mainly so I can quickly bring myself back up to speed after long absences from the code. +These are my notes about the internals of the Local Yarn source code. I wrote them mainly so I can +quickly bring myself back up to speed after long absences from the code. In other words, a personal +reference, rather than a tutorial. You’ll get the most out of these notes if you have read +@other-doc['(lib "pollen/scribblings/pollen.scrbl")], and worked through the tutorials by hand. -This is a @racketmodlink[pollen]{Pollen} project, and it is a bit complicated. At the very least you should have read the @racketmodlink[pollen]{Pollen documentation}, and worked through the tutorials by hand, before delving into this code. +If viewing these notes on the Fossil repository, links that lead out to sites other than +@tt{docs.racket-lang.org} will not work within the “Code Docs” frame, due to the repository’s +@link["https://content-security-policy.com"]{content security policy}. To follow such links, +right-click and open the link in a new tab or window. + @local-table-of-contents[] -@include-section["pollen.scrbl"] +@include-section["pollen.scrbl"] @; pollen.rkt +@include-section["dust.scrbl"] @; dust.rkt