Technical documentation feedback

In order to improve our services, we would like your feedback and comments on our technical documentation for MitID. Please find the updated version here:MitID | Developer Pages

Is it intuitive and understandable ?
Does it give you sufficient technical information ?
Areas to improve ?