annotations updated for 2.5manual prt 3 + added missing chapters

Missing Chapters: REST-API Design Doc (Manual 2.5) and Appendix: FAQs (Manual 2.2)