initial design and notes; based on developer documentation