Some practical hints for my first HYDRA implementation

Hi there,
I would like to define my API description and have some feedback. Mostly I
need some practical hints on how to correct and complete my
ApiDocumentation. I have barely started to sketch the vocabulary.

Here's the API:

GET http://rdfendpoints.appspot.com/hypermedia/spacecraft/
The EntryPoint, from here it's possible to reach the subsystems (different
families of systems in a spacecraft):

GET http://rdfendpoints.appspot.com/hypermedia/spacecraft/subsystems
where it's possible to choose one of the subsystem

If we choose for example the propulsion system:
GET
http://rdfendpoints.appspot.com/hypermedia/spacecraft/subsystems?uuid=Spacecraft_Propulsion

>From here you can see the different components belonging to a family:
GET
http://rdfendpoints.appspot.com/hypermedia/spacecraft/components?uuid=Spacecraft_Propulsion

And finally the Resource Component:
GET
http://rdfendpoints.appspot.com/hypermedia/spacecraft/components?uuid=4f44803d9d1d4b1f8c90b265ab10371e

The basic vocabulary:
GET http://rdfendpoints.appspot.com/hydra/vocab

I have tried to set the headers but I don't know if they are fully working,
the documentation in the Hydra Console obviously doesn't work, as the
ApiDocumentation is probably messy and incomplete.
Endorse patience! It's my first experiment with HYDRA (:

Regards.
-- 
¤ acM ¤
Lorenzo
Moriondo
@lorenzogotuned