Details
-
Type:
Story
-
Status: To Do
-
Resolution: Unresolved
-
Fix Version/s: None
-
Component/s: Stack Documentation and UX
-
Labels:
Description
From the DM-14852 review:
Would it be helpful to have data-format or data-type here? From the perspective of a newbie unfamiliar with random things the hardest part about following code is not knowing the format of the thing all the code is acting upon
This ticket is to identify how dataset packages could be better documented, and to provide those new guidelines.
Test datasets that are imported by a butler at least mitigate this problem in that the user code should only need to understand the python type that comes from butler.get.