编程规范接口描述应该包括以下几个方面：
标题和描述
接口的标题应简洁明了，能够清楚地表达接口的功能或用途。
接口的描述应对接口的整体功能、输入参数、输出结果以及使用方法进行详细的阐述。这有助于其他开发者快速理解接口的作用和用法。
接口命名约定
接口的命名应遵循Java的命名规范，使用“接口名”作为前缀，后跟具体的名称。例如，“UserService接口”或“UserServiceInterface”。
命名应具有描述性，能够清晰地表达接口的作用或所属领域。
接口方法描述
每个接口方法的描述应包括方法名、参数列表、返回值以及方法的功能说明。
方法的描述应简洁明了，能够清楚地表达方法的作用和用法。
参数说明
对于接口方法的参数，应详细列出参数的名称、类型、作用以及取值范围。
如果参数有默认值，应在文档中明确标注。
返回值说明
对于接口方法的返回值，应明确说明返回值的类型以及代表的意义。
如果返回值可能为null，应在文档中进行标注，并解释在什么情况下会返回null。
异常说明
列出接口方法可能抛出的所有异常，并简要描述每个异常的含义和原因。
提供异常处理的建议或示例代码，以帮助调用者更好地处理异常情况。
使用者说明
建议将每个接口当做一个用例放在实现它的主题域中描述，在详细描述接口时，就必须详细地说明该接口者的使用者。
包括使用者名称、业务目的、使用时机和使用频率。
内容与格式
对双方所传递的信息、顺序进行描述，并详细说明数据的构成与格式。
交互过程说明：在调用接口时，数据的传输方向、顺序信息。
数据包说明：对前面标识出来的各次数据传输的内容与格式做进一步说明，内容包括什么属性、每个属性的格式、长度等信息。
其他
遵循RESTful API设计原则，使用合适的HTTP方法（GET、POST、PUT、DELETE）来表示资源的操作，使用URL来标识资源，使用合适的状态码来表示操作结果。
遵循统一的命名规范，接口的命名应该具有清晰、简洁、一致的特点，以便于开发者理解和使用。
接口的设计原则包括单一职责原则（SRP），即一个接口只负责一种功能，以提高代码的可读性和可维护性。
通过遵循以上规范，可以编写出清晰、易读且易于维护的接口文档，从而提高开发效率和系统的可扩展性。