Project

A project is the top-level repo containing all the metainformation about the code. Code repos should normally be submodules of a project. A project root dir is seen as the root by many tools. Project file tree layout:

  1. meta/ a must-have dir of work manuals, must read first before working,
  2. wiki/ a wiki of key concepts, <100 pages, optional read,
  3. todo/ an issue tracker, full of tickets,
  4. html/ a generated static web site, mirrors the project's tree: html/wiki/ etc
  5. work/ where worktrees/branches live, gitignored otherwise,
  6. jsrc/ JAB javascripts of local automation.

Addressing (context URIs etc)

Inner addressing refers to the project as //, e.g. ///be/shared is shared/ of bagle-ext/ main tree as it is mounted in the project tree. //ABC-123/shared/ might be the same dir in the ABC-123 worktree (which only consists of beagle-ext).