diff --git a/2024/documents/README.md b/2024/documents/README.md new file mode 100644 index 0000000..9399ebf --- /dev/null +++ b/2024/documents/README.md @@ -0,0 +1,37 @@ +# alexandria, the document repository + +This is where documents and their derivations are stored. The source code of +the document and its corresponding `package.nix` are placed in the same place. + +There are two ways to organize documents. You can directly place the document +in [by-name](./by-name/), suitable for documents not assorted with a +particular course and various miscellany. + +For documents related to specific courses, it is preferable to create a +directory for that course in [by-course](./by-course/), and then nesting the +document directory within the course directory. This will create a nested +structure for the packages as well. + +For example, the following path: + +``` +by-name/my-document +``` + +will result in a package set containing `my-document`. + +The path + +``` +by-course/phil-1/paper-1 +``` + +results in a nested package set containing `phil-1.paper-1`. That means that +you can build that document with the command + +```sh +nix build .#phil-1.paper-1 +``` + +It's evident that this organization structure could be useful for organizing by +some topics other than courses, so the naming may change in the future.