a bit of documentation of the code structure and add resources to the document item api