wikis, rubrics and views: an integrated approach to improving documentation
DESCRIPTION
For many years scientists and data managers have focused on creating metadata that supports the discovery of available data. This is important, but once data sets are discovered, users need metadata that supports use and understanding of those data. This talk describes a system developed to support the required metadata improvements using wikis, rubrics, and metadata views. The wikis provide a mechanism for the community to record experiences and lessons learned and provide high-quality examples. Rubrics provide a mechanism for consistent and clear quantitative evaluation of the completeness of metadata records. The results displays include integrated links to the wiki. Views provide views with connections to the wiki and on-going interactive learning. These tools can be used with metadata from any standard and can facilitate translation of the metadata between multiple standards.TRANSCRIPT
![Page 1: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/1.jpg)
Wikis, Rubrics, Views and Connections: An Integrated Approach to Improving DocumentationTed Habermann, The HDF GroupAnna Milan, NOAA/NESDIS/NGDC
WikiWiki
Rubrics Views Connections
Web Accessible Folder Web Accessible Folder
Portals
![Page 2: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/2.jpg)
The Data Management Wiki
WikiWiki
The NOAA Data Management wiki is a community knowledge resource developed and maintained by a small group in NOAA and available to all.
It is the heart of the tools.
https://geo-ide.noaa.gov/wiki
![Page 3: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/3.jpg)
Wiki Pages
Discussion• Explanation, guidance, rationale,
examples• Developed first – organic evolution in
response to community needs
![Page 4: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/4.jpg)
Wiki Pages
Discussion• Explanation, guidance, rationale,
examples• Developed first – organic evolution in
response to community needsClass / Element• Structure, order, alternatives• Came later for specific support of
metadata editing
![Page 5: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/5.jpg)
Wiki Pages
Discussion• Explanation, guidance, rationale,
examples• Developed first – organic evolution in
response to community needsClass / Element• Structure, order, alternatives• Came later for specific support of
metadata editing Training• Part of structured paths through wiki
content
![Page 6: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/6.jpg)
Wiki Navigation
Categories• Automatic mediaWiki Capability• Many-to-Many, Sub-Categories
![Page 7: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/7.jpg)
Wiki Navigation
Categories• Automatic mediaWiki Capability• Many-to-Many, Sub-Categories
Categories as “Home Pages”• Automatic page lists• Simplifies navigation and maintenance
![Page 8: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/8.jpg)
Wiki Navigation
Categories• Automatic mediaWiki Capability• Many-to-Many, Sub-Categories
Categories as “Home Pages”• Automatic page lists• Simplifies navigation and maintenance
ISO Explorer• Consistent presentation (templates)• Follows structure of standard
![Page 9: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/9.jpg)
5242
5
232
127
359
255
Content Creation
![Page 10: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/10.jpg)
49
173
5231
111
269
Content Updates
![Page 11: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/11.jpg)
Web Accessible Folder Web Accessible Folder
Web Accessible Folders
Titles Links Scores Dates Views
![Page 12: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/12.jpg)
Guide View (HTML)
WikiWiki
![Page 13: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/13.jpg)
Metadata Evaluation
• Requires conventions or model that can be used for evaluation (a set of suggested fields and practices)
• Oriented towards use cases (text search, spatial/temporal search, lineage, …)
• Evaluates completeness, not quality• Designated Community Representatives
(OAIS) = gold standard
![Page 14: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/14.jpg)
WikiWiki
Rubrics are made of Spirals made of Fields
Rubric
Spiral
Field Field Field Field
Spiral
Field Field
![Page 15: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/15.jpg)
Spiral = Concepts To Address Documentation Need
Opportunities for improvement
![Page 16: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/16.jpg)
Spiral None 0-33% 34-66% 67-99% All
Identification
Connection
Extent
Distribution
Description
Content
Lineage
AcquisitionInformation
Metadata Evaluation for Dataset XDate: 2012/08/14
Spirals and Rubrics
Each record has a score that can be calculated using a consistent, standard tool
![Page 17: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/17.jpg)
Spiral None 0-33% 34-66% 67-99% All
Identification
Connection
Extent
Distribution
Description
Content
Lineage
AcquisitionInformation
Metadata Evaluation for Dataset XDate: 2012/08/14
Spirals and Rubrics
Progress
GOAL
S
Each record has a score that can be calculated using a consistent, standard tool
![Page 18: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/18.jpg)
Spiral = Concepts That Address Documentation Need
WikiLinks
![Page 19: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/19.jpg)
Connections Between Multiple Standards
![Page 20: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/20.jpg)
Connections Between Multiple Standards
![Page 21: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.vdocument.in/reader036/viewer/2022062617/54b8dc8e4a7959313c8b45a2/html5/thumbnails/21.jpg)
An Integrated Approach to Improving Documentation
WikiWiki
Rubrics Views Connections
Web Accessible Folder Web Accessible Folder
Portals