fixed missing url encoding
added note to missing diagram in docs