public interface docs