DimensionalData.jl icon indicating copy to clipboard operation
DimensionalData.jl copied to clipboard

Improvements to docstrings

Open felixcremer opened this issue 1 year ago • 12 comments

I am currently reading through the docstrings and will capture confusions and possible improvements here. Feel free to ignore for now.

felixcremer avatar Mar 19 '24 22:03 felixcremer

Label keyword in Bins not documented

felixcremer avatar Mar 19 '24 22:03 felixcremer

Label describtion in CyclicBins should be generic and not mentio months

felixcremer avatar Mar 21 '24 07:03 felixcremer

Typos in DimStack docstring amd maching

felixcremer avatar Mar 22 '24 22:03 felixcremer

DimStackInterface should mention AbstractDimStack instead of Abstractdimarray

felixcremer avatar Mar 22 '24 22:03 felixcremer

DimTable example should show DimTable

felixcremer avatar Mar 23 '24 05:03 felixcremer

Dimensions docstring could mention exports and most common use cases. Maybe use parts of IDim docstring

felixcremer avatar Mar 23 '24 12:03 felixcremer

Clarify differences betwen DimPoints and DimIndices and DimKeys DimSelectors

felixcremer avatar Mar 23 '24 12:03 felixcremer

Clarify differences betwen DimPoints and DimIndices and DimKeys

felixcremer avatar Mar 23 '24 23:03 felixcremer

Evne in LookupArrays docstring also mention exports

felixcremer avatar Mar 23 '24 23:03 felixcremer

Does Near give a warning when out of bounds?

felixcremer avatar Mar 23 '24 23:03 felixcremer

Near gets the nearest however far that is, so no.

rafaqz avatar Mar 23 '24 23:03 rafaqz

Should result in DimSelectors example be two dim not three dim?

felixcremer avatar Mar 27 '24 23:03 felixcremer