A Requirement section should be included.

I would like to have a more detailed description of what the Actuation Space Resource is and how it fits into the SENSEI framework (and interacts with other framework components, e.g. the SQR, RD etc...). See for example how the Privacy & Billing sections Introduction and Deployment scenarios sections are structured.

The Requirement section should include information about default ports used and how to change port numbers if these are already in use on the users machine. On my machine I get:

INFO: Starting the internal HTTP server on port 8182
1657 [Thread-1] FATAL eu.neclab.sensei.actuation.asr.ASRResourceActivator  - Couldn't start the actuation REP
java.net.BindException: Address already in use: JVM_Bind
	at java.net.PlainSocketImpl.socketBind(Native Method)
	at java.net.PlainSocketImpl.bind(Unknown Source)
	at java.net.ServerSocket.bind(Unknown Source)
	at java.net.ServerSocket.bind(Unknown Source)
	at org.restlet.engine.http.connector.BaseServerHelper.createServerSocket(BaseServerHelper.java:118)
	at org.restlet.engine.http.connector.BaseServerHelper.start(BaseServerHelper.java:246)
	at org.restlet.engine.http.connector.HttpServerHelper.start(HttpServerHelper.java:69)
	at org.restlet.Server.start(Server.java:571)
	at org.restlet.Component.startServers(Component.java:603)
	at org.restlet.Component.start(Component.java:530)
	at eu.neclab.sensei.actuation.asr.SimpleActuationSpaceREP.startup(Unknown Source)
	at eu.neclab.sensei.actuation.asr.ASRResourceActivator.doRegister(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.dependencyFound(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.access$000(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator$2.serviceChanged(Unknown Source)
	at org.eclipse.osgi.internal.serviceregistry.FilteredServiceListener.serviceChanged(FilteredServiceListener.java:124)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.dispatchEvent(BundleContextImpl.java:930)
	at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventManager.java:220)
	at org.eclipse.osgi.framework.eventmgr.ListenerQueue.dispatchEventSynchronous(ListenerQueue.java:149)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEventPrivileged(ServiceRegistry.java:757)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEvent(ServiceRegistry.java:712)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistrationImpl.register(ServiceRegistrationImpl.java:129)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.registerService(ServiceRegistry.java:206)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:506)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:524)
	at eu.neclab.cmf.lastpoint.Activator.doRegister(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.dependencyFound(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.access$000(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator$2.serviceChanged(Unknown Source)
	at org.eclipse.osgi.internal.serviceregistry.FilteredServiceListener.serviceChanged(FilteredServiceListener.java:124)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.dispatchEvent(BundleContextImpl.java:930)
	at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventManager.java:220)
	at org.eclipse.osgi.framework.eventmgr.ListenerQueue.dispatchEventSynchronous(ListenerQueue.java:149)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEventPrivileged(ServiceRegistry.java:757)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEvent(ServiceRegistry.java:712)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistrationImpl.register(ServiceRegistrationImpl.java:129)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.registerService(ServiceRegistry.java:206)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:506)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:524)
	at eu.neclab.cmf.contextAgent.ContextAgentActivator.doRegister(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.dependencyFound(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.access$000(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator$2.serviceChanged(Unknown Source)
	at org.eclipse.osgi.internal.serviceregistry.FilteredServiceListener.serviceChanged(FilteredServiceListener.java:124)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.dispatchEvent(BundleContextImpl.java:930)
	at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventManager.java:220)
	at org.eclipse.osgi.framework.eventmgr.ListenerQueue.dispatchEventSynchronous(ListenerQueue.java:149)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEventPrivileged(ServiceRegistry.java:757)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEvent(ServiceRegistry.java:712)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistrationImpl.register(ServiceRegistrationImpl.java:129)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.registerService(ServiceRegistry.java:206)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:506)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:524)
	at eu.neclab.cmf.pep.DummyPolicyEnforcementPointActivator.doRegister(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.dependencyFound(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator.access$000(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator$2.serviceChanged(Unknown Source)
	at org.eclipse.osgi.internal.serviceregistry.FilteredServiceListener.serviceChanged(FilteredServiceListener.java:124)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.dispatchEvent(BundleContextImpl.java:930)
	at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventManager.java:220)
	at org.eclipse.osgi.framework.eventmgr.ListenerQueue.dispatchEventSynchronous(ListenerQueue.java:149)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEventPrivileged(ServiceRegistry.java:757)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.publishServiceEvent(ServiceRegistry.java:712)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistrationImpl.register(ServiceRegistrationImpl.java:129)
	at org.eclipse.osgi.internal.serviceregistry.ServiceRegistry.registerService(ServiceRegistry.java:206)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:506)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.registerService(BundleContextImpl.java:524)
	at eu.neclab.cmf.cac.CACActivator.doRegister(Unknown Source)
	at eu.neclab.cmf.helpers.osgi.BaseActivator$1.run(Unknown Source)
	at java.lang.Thread.run(Unknown Source)