documenting parsing methods