[KARAF-2511] Review and update the extending page of the developers guide
Fix build of manual