Document full project. Lots of small fixes

src/assemblage.lua

@@ -1,10 +1,15 @@
 --- Assemblage
+-- An Assemblage is a function that 'makes' an entity something.
+-- It does this by :give'ing or :ensure'ing Components, or by :assemble'ing the Entity.
 
 local Assemblage = {}
 Assemblage.__mt = {
    __index = Assemblage,
 }
 
+--- Creates a new Assemblage.
+-- @param assemble Function that assembles an Entity
+-- @return A new Assemblage
 function Assemblage.new(assemble)
    local assemblage = setmetatable({
       __assemble = assemble,
@@ -15,6 +20,11 @@ function Assemblage.new(assemble)
    return assemblage
 end
 
+--- Assembles an Entity.
+-- @see Entity:assemble
+-- @param e Entity to assemble
+-- @param ... Varargs to pass to the assemble function
+-- @ return self
 function Assemblage:assemble(e, ...)
    self.__assemble(e, ...)