additional docs for updated structure