Next generation Wikis: Mixing Content-Oriented Applications with Wikis
Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation
-
Upload
ted-habermann -
Category
Technology
-
view
281 -
download
1
description
Transcript of Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation
![Page 1: Wikis, Rubrics and Views: An Integrated Approach to Improving Documentation](https://reader036.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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.fdocuments.us/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