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

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)