Author:
OSKB Admin, Marcy Reedy, Crystal Steltenpohl, April Clyburne-Sherin, Felix Henninger, Erin Buchanan, Neha Moopen
Subject:
Education
Material Type:
Module
Level:
Graduate / Professional
Tags:
License:
Creative Commons Attribution
Language:
English
Media Formats:
Text/HTML

Authoring a resource on the OSKB

Authoring a resource on the OSKB

Overview

Welcome to the Open Scholarship Knowledge Base! When you find that there is a gap in this knowledge base or have a good idea for a new resource to create, you can author your own by following this guide. This resource includes a how-to video showing the steps needed. It also includes written instructions on editing the resource, adding formatting and sections, aligning it with the OSKB metadata, and making it discoverable.

Select a group to host your resource

Authoring a resource on the OSKB

Select a group to host your resource

  • Groups on the OSKB are organized by stakeholder, interest, region, or discipline. Join a Group and navigate to the Group page.
  • Click “Contribute to this Group” on the Group page.
  • Select “Open Author” to write a new resource.

 

 

Template for using Open Author to submit resources from the web

If you are using Open Author to submit a resource from the Web, please include the below in your Main Content:

Main Content of an Open Author Resource

Link to External Resource, if adding through Open Author for licensing or material type reasons.

Required

Authors: First Last, separated by commas

Educational use: How can this resource be used for learning? For example, self-paced/independent learning, or classroom use.

Abstract: If the resource has an abstract, please add the Abstract text.

Optional

Audience:

Level: Introductory / Intermediate / Advanced

Prerequisites: None / Link to recommended prior reading or resource

 

Edit your resource

  • Type your content directly into the “Main Content” text box
  • You can upload existing content from Google Docs by clicking “Import from Google Docs” below the “Main Content” text box
  • Add an informative Title to your resource
  • You can add formatting to your text using the buttons above the “Main Content” text box
  • You can also embed videos into your resource using the video button
  • Add “Instructor Notes” that can be seen only by the Instructor rather than the Student view
  • Add Sections to the resource, which will be similar to pages or chapters in a book
  • Click the “Accessibility Checker” above the “Main Content” text box for each section to see if there are common barriers to accessibility in your resource
  • Click “Save” when you make changes

Preview and Publish your resource

  • To see how your resource will look when it is published, you can click “Preview” at any time while editing
  • Select “Student View” to see the resource without Instructor Notes, or “Instructor View” to see the resource including Instructor Notes
  • Check for formatting issues or ways to better organize the sections
  • When you are happy with your Preview and resource content, click “Publish”
  • You will then be asked to describe your resource

 

Template for completing the Overview section of the description for a resource from the web

If you are using Open Author to submit a resource from the Web, please include the below in your Overview section of the Description:

Overview section of Description (this content will mirror most of your Main Content)

Required

Educational use: How can this resource be used for learning? For example, self-paced/independent learning, or classroom use.

Abstract: If the resource has an abstract, please add the Abstract text.

Optional

Audience:

Level: Introductory / Intermediate / Advanced

Prerequisites: None / Link to recommended prior reading or resource

Add and edit the resource description

  • For the resource description, write something similar to an Abstract that introduces the reader to a summary of the resource content
  • Choose a Creative Commons license for your resource, based on whether you will require attribution (CC-BY) or not (CC-0), and whether you will require additional reuse restrictions.
  • Select multiple options for your metadata fields whenever you wish.
  • Some metadata options are intended for the broader OER Commons community, which includes educational institutions beyond university and college, such as elementary schools. For example:
    • Primary User: If your resource could be used by educators and researchers, select “Teacher” and “Student” for these fields.
    • Most OSKB resources will be focussed on university and college teaching. If so, under “Education Level” select “Graduate / Professional” and you can skip the “Educational Standards” and “Grades” sections.

Choose keywords that align with OSKB keywords

  • First, type keywords relating to the intended audience of your resource. Use multiple if you wish:
  • Educators
  • Funders
  • Librarians
  • Policy makers
  • Publishers
  • Research Administration
  • Researchers
  • Students
  • Other
  • Next, type keywords relating to the topics of your resource. Use multiple if you wish:
  • Altmetrics
  • Automation
  • Citations
  • Citizen Science
  • Clinical trial registries
  • Contributing
  • Controlled-access data
  • Copyright
  • Courses
  • Curriculum Change
  • Data Protection and Privacy
  • Data Repositories
  • Dissemination
  • Diversity, Inclusion, and Accessibility
  • Documentation
  • Ethics
  • FAIR Data
  • Funder Policies
  • Gender
  • Governance
  • Governmental Policies
  • Guidelines
  • Human Subjects Protection
  • Institutional Policies
  • Intellectual Property Rights
  • Licenses
  • Literate Programming
  • Maintenance
  • Metadata
  • Metrics
  • Open Access
  • Open Access Policies
  • Open Data
  • Open Data Policies
  • Open Education
  • Open Educational Resources
  • Open Government Data
  • Open Metrics
  • Open Scholarship Evaluation
  • Open Scholarship Guidelines
  • Open Scholarship Policy
  • Open Scholarship Tools and Technologies
  • Open Source
  • Open Standards
  • Organization
  • Organizational Change
  • Participatory Research and Innovation
  • Peer Review
  • Preprints
  • Preregistration
  • Public Engagement
  • Public Understanding of Science
  • Publisher Policies
  • Publishing Models
  • Registered Reports
  • Replication
  • Repositories
  • Research Code
  • Research Data Management
  • Research Data Management Policies
  • Research Data Management Services
  • Research Data Management Standards
  • Research Data Management Tools
  • Research Integrity
  • Science Education
  • Scientific Literacy
  • Standards
  • Statistics
  • Subject policies
  • Text and Data Mining
  • Version Control
  • Workflow tools
  • Workshops
  • Finally, select a high level topic word to align with the OSKB main collections. Use multiple if you wish:
  • Data
  • Education
  • Publishing
  • Policy
  • Materials
  • Analysis
  • Reproducibility