IDL Problem Code 82
with alias docs-prop-too-few-params
Want to disable me? Check out the configuration guide to learn more.
Documentation Best Practice
This problem indicates that there's an opportunity to improve the documentation for your code.
This helps make sure the extension can properly detect types, provide a better user experience, and ensures other users can be successful with code that you write.
Want to automate documentation generation? Learn about comment style and AutoDoc here.
This problem indicates that the documentation for a structure property does not include the type of the property.
Here is an example of the problem:
idl
;+
; :MyStruct:
; prop1:
; First property
; prop2:
; Second property
;
;-
pro MyStruct__define
compile_opt idl2
void = {MyStruct, prop1: '', prop2: 42}
end
Which can be fixed by adding the types of the properties to the docs:
idl
;+
; :MyStruct:
; prop1: String
; First property
; prop2: Number
; Second property
;
;-
pro MyStruct__define
compile_opt idl2
void = {MyStruct, prop1: '', prop2: 42}
end