code: private List<String> convertImports( Collection<ImportedVariable> importedVariables ) {
  
  		List<String> result = new ArrayList<> ();
  		for( ImportedVariable var : importedVariables ) {
  			String componentOrFacet = VariableHelpers.parseVariableName( var.getName()).getKey();
  			String s = applyLink( var.getName(), componentOrFacet );
  			s += var.isOptional() ? this.messages.get( "optional" ) : this.messages.get( "required" ); //$NON-NLS-1$ //$NON-NLS-2$
  			if( var.isExternal())
  				s += this.messages.get( "external" ); //$NON-NLS-1$
  
  			result.add( s );
  		}
  
  		return result;
  	}
docs: Converts imports to a human-readable text.
  @param importedVariables a non-null set of imported variables
  @return a non-null list of string, one entry per import