Tips & Tricks « Ecampus Course Development and Training

In my last post, I wrote about how designing an ‘open course‘ empowers others to make desired edits more easily. One major component of an open course is providing adequate and accurate documentation for your intended audience. If you were handed a course to teach or redesign, what aspects about the course would you like to know? Probably as much as possible, which would require a strong set of documentation detailing design processes and decisions, learning outcomes, tutorials for using novel course elements, and so on. If you care about having a solid set of documentation for your courses, then you may be a ‘Documentarian‘. In this post, I look into some components of good documentation design from the software field, and apply them to instructional design.

Informing the recommendations of this post are the Documentation Principles of Write the Docs, a “global community of people who care about documentation”. As described by the Write the Docs authors, their set of principles:

“seeks to define similar standards for software documentation that, when practiced, will foster clean and intuitive content”
https://www.writethedocs.org/guide/writing/docs-principles/#documentation-principles

While software is the stated primary purpose of these principles, much of it is applicable across a wider range of subjects, with aspects of instructional design (such as design and code choices) falling into similar categories.

Why is documentation important?

Every Instructional Designer will work with many different people, known as stakeholders, across every project. The stakeholders of a project fulfill different roles and have distinct requirements. Fellow Instructional Designers, eLearning Developers, Middle and Senior Managers, Subject Matter Experts, and the learners themselves are all examples of stakeholders with different needs and roles. Each of the stakeholders on any particular project will require a certain level of documentation matching their needs. Use of an external tool, for example warrants instructions for how to incorporate the tool into an LMS and its functions for designers, but also instructions on how to use the tool as a user for the learners on the course.

Perhaps some of the most important people to consider when designing a course are the ones who will inherit it later on when the original designers have moved onto other projects. Because of this inevitability, proper documentation is key to understanding how a course was designed, the original intended audience or needs analysis (in case any prerequisite courses are changed in a way that breaks the flow of this one – example: switching from one programming language to another in the classes leading up to this, resulting in it not being fit for purpose), decisions made and why they were taken, how certain features work, just to name a few.

With these reasons for well-structured documentation in mind, what should designers include in documentation? For that, Write the Docs has some advice.

General recommended documentation principles

Write the Docs breaks down “good documentation” into multiple components. The full explanation of each can be found on their Documentation Principles page. Here, I will just use the summary of each one from the page.

The components state:

Documentation should be:

Precursory: Begin documenting before you begin developing.
Participatory: In the documentation process, include everyone from developers to end users.

The content (meaning how documentation is written) should be:

Arid: Accept (some) Repetition In Documentation.
Skimmable: Structure content to help readers identify and skip over concepts which they already understand or see are not relevant to their immediate questions.
Exemplary: Include (some) examples and tutorials in content.
Consistent: Use consistent language and formatting in content.
Current: Consider incorrect documentation to be worse than missing documentation.

Sources (meaning where content creators store documentation) should be:

Nearby: Store sources as close as possible to the code which they document.
Unique: Eliminate content overlap between separate sources.

Each publication (meaning the end product that users see) should be:

Discoverable: Funnel users intuitively towards publications through all likely pathways.
Addressable: Provide addresses to readers which link directly to content at a granular level.
Cumulative: Content should be ordered to cover prerequisite concepts first.
Complete: Within each publication, cover concepts in-full, or not at all.
Beautiful: Visual style should be intentional and aesthetically pleasing.

A documentation body should be:

Comprehensive: Ensure that together, all the publications in the body of documentation can answer all questions the user is likely to have.

Documenting course designs

Taking the above principles, which were initially designed for software, as a guide, we can see how they would fit into the field of instructional design.

General ideas

The principles of documentation being precursory and participatory are simple to follow, especially if one takes on a project management role in course design. Intake meetings and early plans are the first steps to crafting course design documentation. It is at this stage that the initial course design plans are mapped out by the stakeholders on the project. This includes Designers, Faculty, Project Managers and Product Owners (if these are separate people), to name a few. The initial plans for learning outcomes, assessments, and general ideas for activities on a more granular scale can all be converted into documentation on the structure of the course. These would usually fit into a ‘Design Solution’ document that gives an overview of how higher level course decisions are put into practice, or at least intended to be, once the course is running. An ID and the rest of the course design team could revisit this documentation during an evaluative stage to see if things were still going to plan, or modify it based on feedback.

Intended learner journey

I use the phrase “learner journey” a lot, but I am not entirely sure how well known it is, nor if I am using it in a standard way. So for this instance, my meaning of “learner journey” is the following: How the course developer is expecting the learner(s) to interact with the course site. This includes things such as: what learners are expected to click on when reaching the course landing page, the order in which they are expected to complete modules, how assignments are completed, etc. There is room here for interpretation, but it does not hurt to note the intended learner interactions and progression through a course. That way, other faculty members who may be teaching the course in the future can quickly understand learner progression too. This could take the form of a more technical document for fellow instructors, and a quick video for students (or more, depending on how in-depth you wish to go in the learner-facing side of things).

As an Instructional Designer, I often take on the role of the learner sometime during a course development. I will set out a specific meeting time with a faculty member to go through how I would approach this content as a learner, and ask them if this was an intended way for the learners to interact with the content. I usually start by following the order of the module, which is usually set up in the order a learner should complete tasks. What happens, though, if a learner decides that they are just not going to bother reading the Overview page for that week (or any week) and skips right to the Assessments? Is there anything preventing the learner from completing an assignment before they know important background information? Maybe some sort of purpose statement would help (e.g. “This assignment will test your knowledge of learning materials for Week 3. You should complete this week’s background reading tasks before submitting your work.”)?

Content, or how documentation is written

Most Instructional Designers will know about how to make a page more readable by including headings, descriptive hyperlinks, and other stylized formatting like ample paragraph breaks and correctly set up list items (ordered and unordered, for example). If you can create documentation in this way, it meets the skimmable principle and helps readers quickly identify the section they are looking for. I would also recommend adding a unique ID to each distinct section of each page so readers can quickly jump to it using a navigation menu. To find out more about this, see the W3Schools HTML id Attribute page. Once these are set up, you can link anyone to a specific part of the page.

In the previous article on designing the open course, I included a section on the “Side by Side Code Block Tutorials” I use to demonstrate new and complex course elements. This aims to hit the exemplary principle, as it gives readers a quick example of how certain elements work and how to manipulate them in the future.

Video tutorials

Video tutorials are another way to give examples using a step by step process, and provide an additional level of personalization that is often missing from text-only tutorials. There are some downsides to video tutorials, however, which may influence the decision to create them.

Each of the following involve the time commitment required to create videos in the first place, and the principle of staying current.

Scripting and editing
- Usually a video tutorial, or series of videos, involves scripting what the person giving the tutorial is going to say. With written documentation, this would usually be the end of the process – but with videos, it is only step one. The written form then needs to be spoken, correctly, and edited to make sure any mistakes are removed or audio synched up with what is happening on the screen.
Editing mistakes or changes
- It advisable before creating a video tutorial to check if the procedure, process, or system is going to remain in place for long enough to make the time investment making a decent tutorial video worth it. It is a lot easier to change text-based tutorials when something changes than record another video. Additionally, videos are a more personalized version of a tutorial, and if the initial video creator moves on to another position or institution, it would no longer be possible to keep the consistency of any other videos in the documentation.

Those who write documentation with others will know about the importance of an agreed upon style guide. Using the same style of writing, formatting, and terminology across pages and writers ensures that no one section or page stands out or looks jarring in comparison to another, thus fulfilling the consistency principle.

Sources, or where content creators store documentation

For an Instructional Designer, it is not always possible to include documentation directly next to the thing it is explaining. For example, certain Learning Management Systems will remove code comments from all pages, leaving just the content. This is contrary to software development in general, where comments can be left inside code without issue. Therefore I recommend expanding the definition of ‘nearby’ when it comes to documentation for online courses to get around this potential problem.

How you, or your institution, store documentation will have a large effect on how people interact with it. Some institutions use specialized software such as the well-known Confluence by Atlassian, which allows collaboration between users. Other platforms such as Google Workspace are easier to start using for universities and colleges, which often already have Google accounts ready to go, and can be used without extra costs. A similar outcome is offered by other platforms such as a WordPress installation with multiple users creating and contributing to existing articles. Depending on the Learning Management System, it is possible to include documentation closer to the course files (such as attaching files to pages), which is recommended under the nearby principle. Using a single repository for documentation is important so that similar and identical information (such as tutorials on the same topic) are not unnecessarily duplicated (i.e. kept unique) in multiple places such as on an LMS, blog, shared docs. For example, a user of Canvas duplicating tutorial pages across courses leads to problems if part of the tutorial needs to change. This means numerous edits across multiple courses as opposed to pointing to one central location that requires edits only once.

Publications, or how someone can find what they are looking for

Continuing from the previous paragraph on Sources (where the writers store documents), the discoverability of the documentation is key. Where are faculty, designers, and support staff likely to look for help on various topics? Consider linking to the established repository where possible – rather than duplicating it across multiple sites. This will make it easier for others to find the help they require. In a previous section, I included a link to the W3Schools HTML id Attribute page. Specifically here, we are interested in the “HTML Bookmarks with ID and Links” section which tells us about how to jump to different “bookmarks” of a very long page. This is handy when you want to point someone directly to a smaller part of a more complicated and longer page. Doing this manually, however, can take a lot of time, but there are shortcuts for creating these IDs.

When writing documentation, I often use Markdown and then export to HTML. During this conversion process, the headings are automatically given a unique ID in HTML. When pointing people to this part of the documentation, I just need to append a # and the ID name of the heading to the end of the URL. This is known as making the documentation addressable, and links the reader directly to where they would be helped the most. For example, I might want you to go directly to the General recommended documentation principles section of this page, and you can do so with that previous link.

The Write the Docs authors ask the following question:

Can a reader follow your entire body of documentation, linearly, from start to finish without getting confused?

Answering “yes” to this would fulfill the requirements of being cumulative, and this is important when writing something like a tutorial for faculty from start to finish. I try to structure HTML tutorial documentation with the absolute basics first, using headings to structure the page, so that if an instructor already knows basic HTML/CSS principles, they can just skip to the sections that are important to them. If they know nothing about it, however, they should be able to start at the beginning and go through the steps in order.

Completeness of a document increases in complexity depending on what you are writing about. Rather than overpromising what will be in the documentation, state to the reader which parts are covered and stick to those. For example, if there are five assessment criteria for an essay titled Essay 1, only covering three of those in a document titled “Assessment Criteria for Essay 1, Explained” would be misleading.

The beauty of a page is subjective, but proper document structure can help enormously. Things like logical reading order of headings, use of whitespace, properly sized images with captions/alt-text go a long way to making documents more readable.

Documentation Body

The time required to make your institution’s documentation comprehensive also depends on the complexity of the systems in use. Write The Docs defines comprehensive documentation as being able to answer all the questions a user is likely to have. Instructional Designers are often connected to all aspects of the course, and can work with the various teams involved to provide the informative questions and answers required to be as comprehensive as possible for all stakeholders.

Conclusion

Creating successful documentation in the Instructional Design field starts from the inception of a project. It begins with the very first needs analysis and ends with a fully comprehensive set of publications that are easy to access by both writers and readers. It is a collaborative process and involves promotion and discoverability. but once created, it provides opportunities for learning, understanding, and importantly, modification and revisions to existing projects. For those thinking of designing an open course, or if you simply like learning more about how things work, perhaps you too are a Documentarian.

References

Chambers, P. (2022, May 23). Designing the open course: Why Instructional Designers should follow a “right to repair” plan. Ecampus Course Development & Training Inspire Blog. https://blogs.oregonstate.edu/inspire/2022/05/23/designing-the-open-course-why-instructional-designers-should-follow-a-right-to-repair-plan/.
HTML id Attribute. Retrieved from https://www.w3schools.com/htmL/html_id.asp.
Mundorff, M. (2022, April 18). An Introduction to Markdown. Ecampus Course Development & Training Inspire Blog. https://blogs.oregonstate.edu/inspire/2022/04/18/an-introduction-to-markdown/.
Write the Docs, CC BY-NC-SA 4.0.

Ashlee M. C. Foster, MSEd | Instructional Design Specialist | Oregon State University Ecampus

Whether a pedagogical approach is affirmed by research and/or practical evidence intentional design and effective deployment of pedagogical strategies are essential. We will begin with an exploration of evidence-based design components, which build upon the characteristics of Project-based Learning (PjBL), as discussed in Project-based Learning (Part 1) – Architecture for Authenticity.

Getting Started

Begin with the end in mind. Take a moment to establish the outcomes, goals, and real-world connections that will underpin the project. Consider using the following elements as your guide.

Identify the Course Learning Outcomes (CLO) students should be able to demonstrate upon successful completion of the course
Identify the intended project outcomes and the alignment to the course learning outcomes
Identify skills students will practice and master while engaging with the project
Articulate the purpose of the project within the contexts of the course, academic program, field of study, and profession
Articulate authentic connections between the project, across academic disciplines, and professional practice
Connect the project to an authentic purpose that extends beyond the confines of the course

Course Design Elements

Next, reflect on how you can design your project to incorporate most of the following PjBL core design elements.

Image credit: Gold Standard Project Based Learning by PBLWorks is licensed under CC BY-NC-ND 4.0.

Authentic Challenge

Initially, consider creating an opportunity for students to self-select a challenge. This can be anything from finding a solution to existing problems, a remedy for historical barriers, answers for disciplinary relevant questions, or asking new questions. Whatever the challenge may be, a best practice is to contextualize it within a real-world context. Affirm student voice and choice by explicitly sharing how the project connects to the academic discipline, professional field of practice, and real issues by providing feedback. Lastly, help students to see how they can connect the challenge to themselves.

Authentic Product

Development of an artifact that is relevant, timely, impactful, and piques personal interest help to bridge the concepts to the real world. To effectively create an artifact that produces a public good, students should engage in an iterative process that includes: planning, prototyping, seeking and applying feedback from diverse stakeholders (i.e., public, target audience, instructor, peers, Subject Matter Expert), personal reflection, and revisions. To determine whether your project is authentic, consider whether the product(s) create a lasting and meaningful impact beyond the classroom. Examples of authentic products could include a business plan to innovate an existing accessibility tool, a podcast to share about (DEI) Diversity Equity and Inclusion practices or to generate oral histories (i.e., audio interviews) of underrepresented populations.

Sustained Inquiry

Incorporation of formal and informal opportunities for students to question, research, gather information, conduct analysis, apply new knowledge, generate additional inquiries, and highlight evidence is key to the design. These opportunities should be integrated into the architecture of the project, but the actions should be student-driven. This strategy will help promote knowledge construction.

Student Autonomy

Create varied opportunities for students to make their own choices, both collectively and individually. Student-driven choice can extend to such elements as question development, selection of public a product, identification of target audiences, establishment of collaboration protocols, application of knowledge and feedback, and prototype revision methods. Doing so situates students as the diver of their own learning process and creates space for students to hone their metacognitive skills (i.e., self-regulation, monitoring, and self-directed learning).

Reflection

Due to its roots in constructivism, reflection is commonly used in PjBL. Reflection is used as a strategy to foster deep learning, personal ownership of learning, assimilation of new knowledge, integration of lived experiences, effective inquiry, assessment of quality, and the navigation of challenges. While serving as a guide on the side, consider integrating activities to foster ongoing reflection of critical questions. Such questions may include:

What is known?
What needs to be known?
What evidence exists?
Will the product have an impact on the world outside of the course? How?
Do I/we bring any personal biases to the project which impacts the design of the product?
Does the design of the product represent the diversity of the target audiences?
What works or does not work? Why?
How can the product be improved? What is the rationale behind the recommended changes?
How can the quality and efficacy of the product be tested?
Does the project extend on what the academic domain and professional field have established? If not, how can the project be modified to contribute additional knowledge or insights?
How does the project connect to my life, my lived experiences, and that of others?
How will the project help me to develop my professional skills?

An example of a PjBL reflective activity is a design journal. Design journals can include text, visualization, and media elements. Each entry can be structured to cover the following: knowledge gained, ideas, sustained inquiry (i.e., questions, additional research needed), the rationale for product changes, and next steps.

Critique & Revision

Integrating activities, such as a design journal, provides students the opportunity to actively critique, revise, and obtain feedback throughout the duration of the project. There is a multitude of scenarios that may call for critique. Students may find their initial idea to be too broad or specific. The original line of inquiry may have been faulty. One may find the product does not generate the intended public good or service. Therefore, revising the goal and creating a new product may be necessary. Alternatively, situations can arise where students learn of a product’s unintended harm, so a new prototype may need to be created. The goal is to create a course climate that is psychologically safe enough to encourage iteration.

Success Tips

Please note that these best practices and design elements offer a framework. Your course is unique. There is an unending list of potential factors that can impact the design of your course and project (e.g., accreditation, professional competencies, academic rigor, program outcomes, administrative expectations, etc.).

Keep in mind that you do not have to incorporate everything and the kitchen sink. Take what you can from existing literature, practitioner testimonials, industry needs, professional practices, real-world examples, and lessons learned from your own lived experiences.
Begin with small additions to your course, assess the impact of those changes, and revise as you deem appropriate.
Remember that nothing will be perfect, and there are always opportunities to improve. Design with the best fit in mind!

Looking Ahead!

You are cordially invited to revisit the Ecampus Course Development and Training Blog for Project-based Learning (Part 3) – Practical Preparation. In the final installment of this series, we will explore additional project-based learning activities, identify opportunities to integrate technology and examine actual project samples.

References

Almulla. (2020). The Effectiveness of the Project-Based Learning (PBL) Approach as a Way to Engage Students in Learning. SAGE Open, 10(3)
Budhai, S. (2016, January 29). Designing Effective Team Projects in Online Courses [blog]. Faculty Focus.
Chen, & Yang, Y.-C. (2019). Revisiting the effects of project-based learning on students’ academic achievement: A meta-analysis investigating moderators. Educational Research Review, 26, 71–81.
Gold Standard PBL: Essential Project Design Elements. (n.d.). Buck Institute for Education.
Grossman, Dean, C. G. P., Kavanagh, S. S., & Herrmann, Z. (2019). Preparing teachers for project-based teaching. Phi Delta Kappan, 100(7), 43–48.
Guo, Saab, N., Post, L. S., & Admiraal, W. (2020). A review of project-based learning in higher education: Student outcomes and measures. International Journal of Educational Research, 102, 101586.
Larmer, J. (2012) PBL: What Does it Take for a Project to be ‘Authentic’? Edutopia
Lewis, R., Gerber, E. M., Carlson, S. E., & Easterday, M. W. (2019). Opportunities for educational innovations in authentic project-based learning: understanding instructor perceived challenges to design for adoption. Educational Technology Research and Development, 67(4), 953–982.
Morgan, T. (2019). Enabling Meaningful Reflection Within Project-Based-Learning in Engineering Design Education. In Design Education Today (pp. 61–90). Springer International Publishing.
Product Toolkits: Scaffolding Guides for Authentic PBL Products. (2012) Buck Institute of Education.
Project Design Rubric. (2015). Buck Institute of Education. Retrieved from: https://www.bie.org/object/document/project_design_rubric

Over the last couple of terms, I joined a series of reading sessions with instructional design colleagues to read Alfie Khon and Susan Blum’s book Ungrading. Why Rating Students Undermines Learning (and What to Do Instead) and discuss the practices and implications of this approach to reconceptualize assessment design and the place of grading. This two-part blog aims to capture the takeaways from those discussions including the main concepts, approaches, types of activities, implications, and challenges of adopting ungrading practices. This first part of the blog covers a brief overview of the concept of ungrading, its major benefits, and design considerations; and the second blog will include a summary of the types of ungrading practices and challenges to implementation ––all derived from the authors’ extensive arguments and examples. For a detailed review and summary of the book chapters, you can also check the blog Assessment Design: Ideas from Ungrading Book.

Overview of Ungrading

The concept of ungrading is sparking widespread interest only recently even though educators have been studying and using ungrading approaches for quite some time. The foundational premise of ungrading is to move away from a focus on grades that judge, rank, sort, and quantify student learning to adopting an approach that focuses on using alternative and authentic means to assess learning such as self-evaluation, reflection, student-generated questions, peer feedback, to name a few. Along with that premise is the questionable ranking that comes with grading which makes students compete with one another in an artificial way. Sorensen-Unruh (chapter 9) sees ungrading as a conversational method that facilitates the communication between instructors and students about how students perform in the class. If, as underscored by the authors, grading and the fact of assigning point values to students’ performance makes more harm than good, then, why use grading? Considering that grading is rooted in our educational systems, many of these authors conclude that it becomes inevitable to grade student learning as it is currently done today.

Several scholars and instructors consider grading to be problematic. First, grades are not good indicators of learning. Blum (chapter 3) argues that grading assumes all students are the same, does not provide accurate information about student learning gains, is consequential, adds fear and avoidance of negative consequences, and is arbitrary and instructor-led. Second, the overemphasis on grades can lead to a decrease in intrinsic motivation, students’ excessive anxiety, and the complexity of quantifying how learning happens (Stommel, chapter 1). Third, it can also decrease interest in learning, students may feel inclined for easier tasks, and critical thinking is lacking (Alfie Khon, foreword). Fourth, grading makes students be fixated more on their grades than on the process of learning, leading them to believe that grades are all that matters in school (Khon & Blum; Talbert, 2020). And finally, too much focus on grades can be detrimental to students’ mental health (Eyler, 2022). However, ungrading does not mean dismissing grades altogether. Instead, Stommel proposes creating a learning space that fosters critical thinking, reflection, and metacognition– all skills that are valuable for 21st-century education. Likewise, Alfie Khon contends that grading can be participatory since it does not require a unilateral decision, and thus, students can also propose their own grades (with the instructor’s reservation to accept them).

“Ultimately ungrading— eliminating the control-based function of grades, with all its attendant harms— means that, as long as the noxious institutional requirement to submit a final grade remains in place, whatever grade each student decides on is the grade we turn in, period.”
(Khon, 2020, p. xv)

While ungrading may be an innovative approach to assessments, it should be thought of carefully and adopted with a clear objective. Ungrading, as pointed out by Katopodis and Davison (chapter 7), needs a structure to be effective, allowing students to envision themselves as authoritative, creative, confident, and active, thus achieving a high impactful goal. As ungrading requires instructors to evolve in their approach to assessment, it does too for students who are expected to engage in a process of self-evaluation, self-assessment, and reflection. This requires engagement in metacognitive practices that many students might not be ready to embark on or don’t know how to do it. In addition, while ungrading is believed to be student-centered, it can deepen equity gaps if guideposts are entirely removed. Sorensen-Unruh (chapter 9) believes that ungrading is a matter of social justice –going beyond the expected student agency and aiming at having students exercise their voice and participate in assessment decisions.

As a whole, Blum (introduction chapter) provokes us all to rethink the nature of grading considering that students’ learning conditions vary, with many enduring inequities at many levels. Blum wants us to keep focused on how “varying assessment and feedback methods contribute to the real learning of real individual learners, rather than imposing an arbitrary method of sorting.” (p. xxii); all for the sake of healthy learning.

These are a few key points about the arguments for ungrading. While this assessment practice is taking force in higher education, there are also many critics and skeptics. The purpose of this blog is not to enter into the discussion and controversy of ungrading, but to share a few perspectives and takeaways after an intense and well-structured book club discussion. In the following section of this part-one blog, I will share considerations for designing for ungrading.

Assessment Design Considerations

Tasks and activities from a laptop computer

The educational system requires all instructors to submit grades at the end of every term. There is dissatisfaction with the current grading practices among many instructors and students as explained at large in the book. Here is where the ungrading movement takes force to provide alternative ways to account for evidence of student learning. Riesbeck (chapter 8) argued that by implementing ungrading practices, students can focus more on the content and feedback than on the grades. The use of critique-driven learning allows for more easily quantifiable efforts, progress, and accomplishment. Each ungrading consideration is dependent on a myriad of factors that may or not apply to each instructor’s context. The bottom line in ungrading is re-envisioning the teaching and learning process, engaging students in active learning, and active self-assessment through feedback. The following are design considerations:

Decenter grading and communicate (un)grading practices

Instructors can encourage students to focus on the process of learning, instead of talking about grades, Blums says, we should talk about the purpose and goals of the activities with students. These conversations can help develop relationships with students to encourage them to own their learning and have a voice in that process. Decentering grades also involves having an ongoing conversation with students, colleagues, and administrators about assessment decisions. Although each instructor exercises their academic freedom, it is also essential to share assessment practices that work and possible changes to implement. In these conversations, it is also important to carefully use language that conveys a clear understanding of the concept and practice of ungrading to avoid confusion, anxiety, misunderstandings, and reactions that prevent its implementation. Having these kinds of conversations can help shift the mind from a grade-focused to a learning-focused approach. A key element in these conversations is to ensure that the pedagogical reason behind the adoption of ungrading practices is not only clear but well understood (and this may take time).

Set a structure for ungrading

As with other elements of exemplary course design considerations, the structure of assessment practices is necessary. Adding a structure for ungrading assignments gives students a clear objective, steps, and flow that allow them to be consistent and accountable to their own learning goals and strategies.

Reflect on pedagogical and assessment practices

Instructors are invited to examine more in-depth their grading policies, why they grade in the way they do, what they are grading, and how they grade. In many cases, the path to ungrading is a response to dissatisfaction with grading policies. Aaron Blackwelder (chapter 2) says that, over time, he turned into a gatekeeper; he lost focus and was more interested in meeting institutional and “rigor” requirements than building relationships with students. His students had turned into competitive grade seekers. He questioned what a grade really suggests and posits that grades fail to communicate learning. The fact that grading allocates a specific number or letter that can bring some negative feelings to students, can also negatively affect the potential for learning. Sackstein (chapter 4) calls for a change in mindset to identify the way in which learning can be communicated and understood beyond the traditional use of numbers and letters. While Blum also argues for assessing the entire learning experience (with portfolios, for example), Sacksatein suggests considering changes in the language of grading which can provide students with an opportunity to shift the way they feel and think about their own learning.

Teach students to view mistakes as a necessary step in the learning process

Instructors are invited to reflect on how traditional grading practices are punitive, dehumanizing, and demotivating. Gibbs (chapter 6) points out that a system that punishes students for making mistakes reinforces the notion that all learning is flawless and therefore mistakes need to be avoided. Ungrading, on the other hand, aims to implement and cement the idea that learning is a process that needs constant feedback for that learning to be consolidated. Therefore, students need to be given opportunities not only to learn from their mistakes but to act on them in an interactive way. This requires instructors to plan for assessments that include steps for review (e.g., self, peer) to help the student build their skills, and knowledge over time.

Care for students and their learning

Instructors are also invited to demonstrate more explicitly that they care and validate students’ work. Further, Gibbs (Chapter 6) argues that her teaching philosophy is better summarized by the word “freedom”, the freedom that learners have to learn and grow at their rhythm and the freedom to make mistakes and learn from them. The role of the instructor is then to be supportive in that process through feedback and empathy. Ungrading, as it is overall discussed throughout the book, does not mean that there are no assessments or grading at all. On the contrary, the assessments should focus on helping students build their knowledge and understanding in less stressful ways, allowing students to build learning habits, develop creativity, become better communicators, and connect to their lived experiences and contexts. Caring for students also involves valuing their identity as learners and what they bring into the learning environment.

Be aware that ungrading can increase student anxiety and uncertainty

It is critical that instructors who are considering ungrading be cognizant that it involves a high level of anxiety and uncertainty on the part of students. Let’s recognize that students are so used and “conditioned” to grades that they will find it confusing not to have a grade associated with each assignment in the course. Many students consider being successful if they score a perfect grade which can be overwhelming and obscure the value of learning. Instructors who adopt ungrading should explain why and how ungrading will be done in certain classes. This will add transparency to the expectations and assumptions that instructors have about students.

Implement student voice and choice supported with personalized feedback

Instructors can help students take ownership of their learning through hands-on, real-life activities that allow students to use the content they are learning in projects of their interest, conduct research, and solve problems. Students can choose their topics and projects and the instructors can guide them to narrow topics and ensure the projects are feasible within the course timeframe. Consider feedback as a formative assessment approach that enables students to make choices about their learning strategies and needs to improve their learning tasks. Sackstein (chapter 4 ) suggests teaching students to collect feedback and identify the strategies that work for different kinds of assignment revisions. This way, students can develop better strategies that move them from lower-thinking to higher-thinking processes.

Since ungrading promotes the use of student-self assessment and reflection practices, it implies that instructors will need to personalize and tailor feedback to meet students where they are. In addition, instructors can consider setting a culture of feedback (Gibbs, chapter 6) where instructors teach students to use feedback to improve their work, provide peer feedback effectively, and see the value of learning from their mistakes.

Promote peer support

Authors of several chapters in this book have posited that students are more likely to give each other better feedback in the absence of grades. This kind of feedback can allow students to help each other, learn from one another, expand their awareness of their own understanding, and develop skills for life. Peer support will also help students build their confidence and autonomy to learn from each other.

Trust students

One critical aspect of assessment is trust –trust that students do the work they are expected to do by themselves. Instructors have legitimate reasons to express their concerns and create course policies about academic integrity that lead them to adopt plagiarism systems and surveillance tools to monitor and proctor students’ work. In adopting ungrading, trust is fundamental to change the way learning and performances are assessed. It involves helping students think differently about what it means to learn. Instructors can help students evolve in their approach to learning to move away from grades to focus on their learning by including in assessments strategies for building capacity for metacognition, confidence in their skills, life-long learning goals, and owning their learning.

Ungrading does not mean instructors don’t grade and students don’t receive grades on their work. Ungrading, as posited by the authors in the Ungrading book, is a mindset to approach student learning differently. In the second part of this blog, I will share the types of ungrading practices, implications, and challenges as presented in the book.

References

Coghlan, S., Miller, T. & Paterson, J. (2021). Good Proctor or “Big Brother”? Ethics of Online Exam Supervision Technologies. Philos. Technol. 34, 1581–1606. https://doi.org/10.1007/s13347-021-00476-1
Eyler, J. (2022, March 7). Grades Are at the Center of the Student Mental Health Crisis. InsideHigher Ed. [Blog]
Kohn, A., & Blum, S. D. (2021). Ungrading: Why Rating Students Undermines Learning (and What to Do Instead). West Virginia University Press.
Shi, T. (2022). Assessment Design: Ideas from Ungrading Book. [Ecampus blog]
Stommel, J. (2020, February 6). Ungrading: an FAQ. [Blog]
Talbert, R. (2022, March 30). Ungrading after 11 weeks. [Blog]

By: Ashlee M. C. Foster MSEd, Instructional Design Specialist | Oregon State University Ecampus

Did you know a pedagogical approach exists that positively impacts student academic achievement and engages them as active participants in learning? Great news…there is! Let me introduce you to the world of Project Based Learning (PBL).

What is PBL?

PBL is a student-centered pedagogical approach where students, both individually and within small groups, engage with meaningful, relevant, and authentic projects which result in a product. Oftentimes, PBL is commonly associated and/or thought to be interchangeable with Problem Based Learning. However, there is a distinction between the two. The principal focus of PBL is on the active construction of knowledge. Additionally, student autonomy, beliefs, values, and motivations are situated as a fundamental driving force of the instructional approach.

What are the characteristics of PBL?

The essence of PBL is anchored in attributes, which foster high-quality learning experiences. Direct instruction is no longer the principal mechanism for delivery. Negotiation of knowledge between the educator and the students occurs through an exchange of ideas, questioning, inquiry, considerations, and perspectives. PBL often engages students in an ongoing process consisting of investigation, collection, analysis, prototyping, testing, peer/instructor feedback, revisions, and reflection. Learner autonomy is key in that students make their own decisions about various aspects of the projects (i.e., line of inquiry, collaborative processes, application of feedback, types of revisions, solutions).

Is it effective? Prove it!

As reported by Chen and Yang (2019), a positive impact on student achievement has been observed across 20 years (i.e. 1998-2017) of PBL peer-reviewed literature. The researcher’s principal investigation was to compare traditional instruction with that of PBL. Traditional instructional delivery was found to prompt students to apply low-level cognitive processes (e.g., understand, remember). Whereas, PBL can encourage the development of (HOTS) Higher Order Thinking Skills (i.e., analysis synthesis) and metacognitive skills (i.e., regulation, monitoring, self-directed learning, evaluation, assessment). According to the meta-analysis, the aforementioned benefits were found not to be impacted by academic discipline, educational stage (undergraduate, post-baccalaureate, graduate), or geographic location. This is great news for our distance and hybrid learners!

How do I get started?

When considering PBL there are a few questions to reflect on before implementing this practice. First, ask yourself, is this a best-fit approach? Consider the academic discipline, subject content, course learning outcomes, your instructional style, student attributes, and the intended goals to answer this foundational question. A word of caution is to use PBL in a way that is relevant, authentic, and collaborative in nature. Steel clear of using projects as a shiny solution. Lastly, contextualize the project. Doing so will help students connect the project to their academic career, professional development, and personal growth. Remember to share the ‘why’!

Project Examples

Here are a few project examples to spark some ideas:

solve a problem (e.g., uninformed voting)
generate a plan (e.g., foster sustainability)
create a product (e.g., computer/mobile application, oral history interviews)
seek valid answers and recommend solutions (e.g., electing national officials)
engage with a persistent issue in a tangible way (e.g., advocating, protesting, public speech)

Do you have an example to share?

Respond in the comments if you currently use, have used, or intend to incorporate PBL in your course. Do you have any tried and true strategies for effective projects? Have you experienced any wins or challenges? Share with the community and join the discussion. Make sure to return to read Project-Based Learning (Part 2) – Mindful Design for practical implementation tips!

References

Almulla. (2020). The Effectiveness of the Project-Based Learning (PBL) Approach as a Way to Engage Students in Learning. SAGE Open, 10(3)
Budhai, S. (2016, January 29). Designing Effective Team Projects in Online Courses [blog]. Faculty Focus.
Chen, & Yang, Y.-C. (2019). Revisiting the effects of project-based learning on students’ academic achievement: A meta-analysis investigating moderators. Educational Research Review, 26, 71–81.
Grossman, Dean, C. G. P., Kavanagh, S. S., & Herrmann, Z. (2019). Preparing teachers for project-based teaching. Phi Delta Kappan, 100(7), 43–48.
Guo, Saab, N., Post, L. S., & Admiraal, W. (2020). A review of project-based learning in higher education: Student outcomes and measures. International Journal of Educational Research, 102, 101586.

Intro

The concept of the ‘right to repair’ has been on my mind recently, both as a user of tech products and as a designer of online courses. Electronics are notorious these days for their enigmatic design. The user is not trusted to make repairs or is restricted in the ways they can interact with device components. This is a choice made by manufacturers to limit access to approved vendors or repair shops. Instructional Designers have a similar choice when building courses. Do we follow a restrictive approach to modifications, or open up courses by anticipating, welcoming, and providing the resources for modifications?

Difficult by design

I recently experienced the restrictive side myself as I needed to fix an air purifier that had an unfortunate run-in with my youngest child and her colorful stickers. Apparently, the inside of the machine was not pretty enough, and the stickers were now stuck inside the machine, not quite clogging up the fan, but making a noticeable noise when the purifier was running. Realizing that I should probably remove them from the mechanism, and the partially obstructed fan, I grabbed my handy screwdriver, and rotated the cylindrical case to find where to begin.

And then I saw it – nothing. There were no screws on the outer shell. I turned it around a few more times, holding on to some hope that there was another way in – some switch to press or clasp to unhook. Nothing. The company designed the device to prevent a consumer from taking it apart. The only thing I had access to was the filter opening. No screws inside there either, and the manual had no sections on repairing the device.

I was put into a situation where I knew what I needed to do, and how to do it, but had no way of accomplishing it. If I tried to open it in a way it was not designed to be (whatever that was), I risked breaking the device even further, and voiding the warranty.

This is the situation many technology users find themselves in these days, which has led to a push for the right to repair one’s own devices.

Right to repair principles

Had the manufacturer made the air purifier with the consumer in mind, it may have been more closely aligned with right to repair principles, which are given by The Repair Association through their Policy Objectives. Some more relevant ones are currently paraphrased on the Right to repair – Wikipedia article:

the device should be constructed and designed in a manner that allows repairs to be made easily;
end users and independent repair providers should be able to access original spare parts and tools (software as well as physical tools) needed to repair the device at fair market conditions;
repairs should by design be possible and not hindered by software programming;
the repairability of a device should be clearly communicated by the manufacturer.

Applicability to Instructional Design

This whole endeavor got me thinking: What is the best choice for designers and developers who create courses and complex elements for our users? It seems that it falls into the same design philosophy choices that we see with other products like computer hardware or electronics today. For simplicity’s sake, let’s narrow it down to these two opposite choices designers have when making course components:

Modifying course elements is made difficult because the designer is either not confident in the instructor’s abilities to properly work with the design, actively discouraging changes, thus resulting in no change until the user approaches the designer(s) again.
Course elements are designed with user modifications in mind, and the user is left with sufficient instructions, access, and ability to make changes when necessary.

I prefer to use technology that closely follows the second choice, as this is more aligned with the ‘right to repair’, and results in more user-friendly practices. That is not to say that everyone would want to modify courses, but the option should be there.

Or, in other words:

It is the philosophical difference between engineering things to make them harder for the end user because you don’t trust them and documenting things to educate the end user so you know you can trust them.
Linus Sebastian, talking about the design choices of a pro-repair consumer laptop

If the previous main points of “right to repair” were to be re-written with online education in mind, how would these look? Perhaps something like this:

The course and its objects should be constructed and designed in a manner that allows edits to be made easily.
Instructors and SMEs should be able to access course components and tools needed to modify the course and its elements.
Revisions and additions should be possible and not hindered by design choices.
The Instructional Designer should clearly communicate the ability to modify the course, and how to do it.

How we could do it

What could we do as course designers to inform and empower faculty? Here are a few ideas:

General Documentation for Course Elements

By far one of the simplest ways to provide support to users is through basic documentation pages. If located on the course site itself, they can remain unpublished so learners do not see them. For those who would like more autonomy over their course structure and design, detailed documentation pages provide an excellent way to take the initiative and make the desired edits. Well-written documentation may also reduce the need for Instructional Designer support after the course is running. Plus, if you, as the designer, are worried about things breaking, you can always have a backup of all materials ready to revert pages.

Side by Side Code Blocks Tutorials

I use these all the time with fellow designers. On a Learning Management System (LMS), these function as a tutorial page where the page is split into two columns. Users can see the HTML/CSS code on the left and how it is displayed on the right. Then it’s a matter of copying the code from the code block and pasting it where they want it to go. This practice is very useful when it comes to the more advanced features of your LMS. This makes it easier to choose which element a user wants to incorporate or edit.

Side by side code tutorial blocks provide a quick way to show off how elements work, and a quick way to copy elements into other parts of the course.

Learner Journey and Alignment

If an instructor wants to change the course a few terms after it has been running, how do we achieve a similar look and feel to the one created by the Instructional Designer long after the project has been developed? Mapping the expected learner journey, and how the content aligns with learning outcomes, can help with this. For example, imagine the learner is expected to interact with a week-long module by completing the following tasks in this order:

Step A (Fulfills Learning Outcomes 1, 3. Informs Steps C and D)
Step B (Fulfills Learning Outcome 2. Informs Steps C and D)
Step C (Fulfills Learning Outcomes 3, 4)
Step D (Fulfills Learning Outcome 1, 4)

Each step may include reading or watching learning materials, completing an assignment, participating in a discussion, and so on. How would this expected behavior change if, later on, an instructor added an additional assessment between C and D? What about removing Step B entirely (which in this example would remove alignment to Learning Outcome 2 from the module). Would a learner on this new version of the course still have the required information to complete the remaining parts of the module? Would they interact with the content in the same order as initially expected (and how the course was likely designed to be completed)?

These are things Instructional Designers plan and check during the initial development which can be shared to ensure that the same methods are followed in subsequent iterations of the course.

Conclusion

Some may prefer to leave everything in the hands of an experienced Instructional Design team, and use their expertise whenever a change is required. For others who have enough technical skills to edit content, the desire to learn more, or would like more autonomy and ownership over course content, an open course design provides the same user-friendly approach that at ‘right to repair’ would have for general electronics.

References

Right to Repair, Wikipedia: https://en.wikipedia.org/wiki/Right_to_repair
Policy Objectives, The Repair Organization: https://www.repair.org/policy
Linus Tech Tips: https://www.youtube.com/c/LinusTechTips

This blog post is an Instructor Spotlight authored by Xiaohui Chang. Xiaohui is a Toomey Faculty Fellow and Associate Professor of Business Analytics in the College of Business. This post is a follow up to Improving Student Engagement and Connection in Online Learning: Part I, Proactive Support.

Introduction

Since the first post in the series appeared a few months ago, we have received plenty of feedback from other instructors who are actively engaged in online education. Some of the stories shared by them reiterate the points we discussed, and others included tips and techniques that have worked particularly well for them. Almost all of them agreed that teaching well online remains a challenging task.

“I love the notes on proactive student support … especially the notes on checking in with those who are behind. Sometimes all they need is a little empathy!”
Vic Matta, Associate Professor, College of Business, Ohio University

“I regularly incorporate each of these in my relationships with my students, to include weekly zoom “what’s up” meetings with my students. I check in on them if they’re behind on assignments…Yes, it takes effort; but my mission is to help these students find the greatness within themselves to succeed.”

To quickly recap what we have discussed in Part 1, we touched on how to employ empathy statements in communications with students, restructure and promote the office hours, provide personal feedback for students, and periodically check in with students who are behind. You may also refer to the first article here: Improving Student Engagement and Connection in Online Learning: Part I, Proactive Support.

Continuing from the first post, Part II will revolve around six specific practices that I have found particularly helpful for online teaching and learning.

Practice 1: Adopt a variety of communication methods

I provide assignment instructions and guidance using a variety of communication methods including texts, diagrams, images, and short video clips. I have learned that instructions with screenshots and videos tend to be better in explaining complicated procedures than text alone.

Video Tutorial Example: Creating a random sample using XLSTAT

Practice 2: Create a Q&A Discussion Board

I have a separate discussion on Canvas for students to address issues with the class in general (content questions, technical issues, deadlines). Instead of emailing the instructor regarding issues other students may also have questions about, students are encouraged to use this forum so that all can benefit from the questions and answers. I usually wait for a few hours for students to answer each other’s questions first before I provide mine.

When students email me questions that are a good fit for the Q&A Discussion Board, I’d respond through email first and then recommend the students submit the questions to the discussion board so that other students can learn from the questions and answers. This discussion board also creates an inviting and engaging learning environment for the students who don’t get to meet their classmates in a face-to-face setting.

Practice 3: Estimate the amount of time taken for each assignment

I was skeptical of this at first as the time taken would vary drastically for each individual. However, student feedback indicates that estimated times helped them plan for the week and set aside an appropriate amount of time. We don’t need to worry too much about making the estimates accurate for everyone as students will automatically adjust given their own work styles. A workload calculator that I have found helpful is developed by the Center for Advancement of Teaching at Wake Forest University, called the Workload Estimator 2.0.

For more information about estimation rates, see the explanation here – Workload Estimator: How We Calculated.

Practice 4: Ensure timely replies

This practice is obvious, but difficult to do when one is teaching multiple sessions with hundreds of students. For online classes, timely replies make students feel as though they are taking an in-person class with all of the built-in support and resources. I understand that we all have different teaching priorities and schedules, however, it all comes down to figuring out how to most efficiently organize our days so that we can be available to students.

Setting aside a couple of times a day for handling emails has worked quite well for me, e.g., the first thing in the morning, after noon, and before the end of the day. I try my best to respond to students’ emails within 24 hours and check my mailbox at least once every day on the weekends.

The timely replies in discussions were super helpful. It really felt as though I took this in person with all of the built-in help and support.
Student quote

Practice 5: Synchronize assignments with Canvas calendar

I have also synced all assignments and my office hours (renamed as Ask Me Anything Hours) on Canvas so that there are office hours available around when assignments are due. This proves to be incredibly convenient and useful for both students and instructors.

Practice 6: Reorganize course content

Here are several Canvas LMS tips that have helped in organizing the course content and saved my time. I try to organize everything in modules. Under each module, all items are split into two main components: resources and to-do lists, so students know exactly what assignments they would need to complete for each module. I also adopt a fixed set of systems for titling Canvas items. Items within modules are indented to help with organization.

Weekly agenda and announcements are also hyperlinked to guide students with the course navigation. I could not emphasize enough how much I value the internal messaging in the Canvas grade book that was briefly discussed in my previous post. This feature allows instructors to message students who haven’t submitted yet or who scored less than a certain point. Definitely a slick way to send quick emails to a target group.

Recently, I have been experimenting with a range of visual cues (e.g., emojis) to categorize course content. An example is provided below.

Screenshot of the module view of the course, demonstrating using of emojis as visual cues next to assignments. A written assignment has a pencil and paper emoji, a quiz has a question mark emoji, etc.

There was also a recent post on using emojis for visual way finding and fostering a friendly tone in online classes here: My Experience with Emojis in Online Courses: Affordances and Considerations.

Conclusion

It’s always best to keep an open mind when trying out new teaching practices and adapt them to your individual style and subject matter.

If you have any online teaching practices that you’re fond of, please feel free to contact me at Xiaohui.Chang@oregonstate.edu as I will be very excited to hear them and test them out.

*Poorly Drawn Lines by Reza Farazmand is licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.*

Adapted from Leo Babauta’s excellent Zen to Done, (itself a remix of sorts of David Allen’s Getting Things Done), this guide has been extremely helpful for my ever-growing to-do list over the years. Whether you’re an instructional designer, faculty member, student, or administrator, I hope this list helps you in your day-to-day tasks!

Collect: Have an idea? Remember something that needs doing? Get it out of your brain!
This tool should be simple and something handy, like a small notebook or a trusted app. Look for something that is portable that you’ll usually have on hand and don’t mind keeping with you. You’ll also want something you’re comfortable with—you’re more likely to use it if you like using it. The simpler and faster you can get those ideas collected for later, the better! Also think about where other items collect on their own—email inboxes, phone messages, etc. How many inboxes do you have?
- What do I use? A mix between a Moleskine notebook for analog capture and Todoist on either my laptop or phone for digital capture, plus my email inbox.
Process: What do you do with all those things you’ve collected and all your various inboxes? I schedule time (usually first thing in the morning as I’m getting started with my day and in the afternoon after lunch) and go through each item in each inbox and follow the ZTD suggested order for making decisions about each one as I process each individual inbox (no need to compile, since anything leftover will be added to a to-do list):
1. Do it (if it takes 2 minutes or less): quick email replies, simple and short tasks, etc.
2. Trash it: newsletters after reading, junk email, information I no longer need, etc.
3. Delegate it: tasks for assistants, tasks I need assistance with, etc.
4. File it away: information I need to hold onto, but don’t need at the current moment—bookmarks, files, etc.
5. Put it on my to-do list: the things I need to schedule time to do!
  I usually allow for around 30 minutes for each process session so I have ample time to attend to everything, including those short tasks, without feeling rushed.
Plan: Now that your list is narrowed down to larger to-do list items, can you identify 1–3 “most important tasks” (MITs) for your current day? How long do you think each task will take? Can you prioritize your MITs for earlier in the day? The more experience I get with this step, the more accurately I can guesstimate how long certain tasks will take and create a daily schedule. On days when I already have a lot of meetings and other obligations, it can be tricky to get a lot done in the small pockets of time between events, so I try to have a prioritized list that I can chip away at as I have time. Anything that doesn’t get done that day is rescheduled for the next as an MIT.
Do: Arguably the most important part of this list, actually doing the tasks you’ve selected is next! Now that inboxes are sorted, this is the perfect time to turn on do-not-disturb, close distracting apps and windows (and all those notifications!), and focus on your selected task(s). If you do get distracted, remember to collect those thoughts/ideas for later so you can get back to the task at hand.
- What do I use? I really like the Pomodoro technique for tasks I expect to take 2+ hours, mostly because it schedules in short breaks that I am prone to skip without it.

There is a lot more to both ZTD and GTD, but these four steps are a great start for taming an unruly to-do list. In the process, you might also find it possible to achieve “inbox zero” (at least during each process step) and reduce some digital clutter and stress in your day-to-day activities.

This past February, I was putting together a proposal for the 2022 Distance Teaching & Learning (DT&L) Conference, and I shared my draft with a couple of my colleagues for feedback.

Typically, when requesting feedback, our team relies on Google Docs, which has a nice feature set for suggesting edits.

However, I was not using Google Docs. I explained that they would be viewing my formatted document on HackMD, a collaborative web-based Markdown tool.

One of the colleagues I had asked for feedback responded:

What are the pros and cons compared to a google doc, may I ask?

That question inspired this blog post.

What is Markdown?

Markdown is a plain text format with a simple syntax to add formatting elements (headings, lists, quotes, bold, italics, etc.). It is easy to convert Markdown files into other formats, such as PDFs, HTML, and rich text. One of the primary uses of Markdown is creating content for the web, which can be done with almost no knowledge of HTML. The first Markdown specification was developed by John Gruber and Aaron Swartz in 2004 and released as Open Source.

What Are the Advantages of Writing in Markdown?

It Is Easy to Learn and Fast to Write

Most markdown syntax is intuitive. Perhaps you are writing a document, and you decide you want to emphasize some text using bold or italics styling. In Markdown, you can surround the words with underscores or asterisks rather than select content and apply a style from a menu or keyboard command. For bold text, add either two asterisks or two underscores before and after the word (your choice, most editors support either syntax):

**bold**
__bold__

For text that you want to be displayed in italics, use one underscore or asterisk before and after the word:

*italics*
_italics_

Creating hyperlinks in documents, a somewhat tedious process in a word-processing program or HTML, is as easy as putting a descriptive link text in brackets and then an address immediately following in parenthesis, like this:

[OSU Canvas Dashboard](https://canvas.oregonstate.edu/)

which in my document becomes: OSU Canvas Dashboard.

It Is Just a Text File

A Markdown file with the extension “.md” is just a plain text file. Storing information in plain text files has several advantages:

Text files are future-proof. You can open a plain text file with any editor on any platform. You are not hostage to the proprietary format chosen by an application developer. You are not dependent on any particular software program still being around to open your Markdown files.
Text files require very little storage. This blog post, written in Markdown, was almost 250% larger once converted to a Microsoft Word document.
Text files are platform-agnostic, making them easy to share with other people or multiple devices. A text file can be opened on a Mac, on Windows, in Chrome OS, in a web browser, on an ios or Android smartphone, or on a Linux machine.
If you open up one of your Markdown text documents in platforms like Box or Dropbox, it automatically renders the HTML.

Markdown is Highly Portable

One of the most significant advantages to writing in Markdown is how easy it is to convert Markdown into virtually any other file format:

HTML: With no knowledge or experience in web development, you can quickly convert Markdown to HTML. There are many ways to convert Markdown to HTML. You can use a web-based tool such as Markdown2Html or StackEdit or work in a text editor with support for exporting Markdown in various formats like Brackets.
RTF: An RTF file keeps basic formatting, such as links or emphasis, while retaining a text file’s flexibility and small size.
PDFs: Many Tools support applying CSS-based styles during a conversion. On my Mac, I use Marked 2 and several of the Marked 2 – Custom Styles to create beautiful PDF files.
Word: Markdown formatting information (titles, headings, quotes, paragraphs, lists, etc.) is retained during conversion. Suppose you convert a document from Markdown to Word. You can then apply any of the built-in styles available in Microsoft Word to format your file instantly.

For a much longer list of the supported conversion file types, explore Pandoc, a universal conversion utility. Using Pandoc, I have converted markdown files into a slide deck, a mind map, a Google Doc, and a Microsoft Word doc, but there are dozens of additional options.

It Is Easier to Read and Write Than HTML

Let’s look at a numbered list with some simple formatting. I have applied bold to item 1 and italics to item 4:

Analysis
Design
Development
Implementation
Evaluation

Here is what that list looks like in Markdown:

1. **Analysis**
2. Design
3. Development
4. _Implementation_
5. Evaluation

If you were to write that same list in HTML, it would look like this:

<ol>
<li><strong>Analysis</strong>
</li><li>Design</li>
<li>Development</li>
<li><em>Implementation</em></li><li>Evaluation</li>
</ol>

Even if you are comfortable coding in HTML, writing the list in Markdown is much quicker and can be quickly converted to HTML at any time.

You Can Write Without Distraction

Using Markdown, I can focus on content rather than the formatting. I can indicate how something should be formatted (as a hyperlink, heading, paragraph, etc.) and then let a MarkDown tool transform my document to numerous other file types. I don’t have to look at dozens of text and paragraph formatting options on a ribbon toolbar or interrupt my writing to apply them.

What Do You Need to Get Started?

A Text Editor

You can write Markdown in any text editor. However, many tools provide a real-time preview of your formatted document and give you several export options. These web-based Markdown tools are free options worth exploring:

Dillinger is a great place to start. You can experiment with the syntax and instantly preview your content without installing any software on your computer. StackEdit works much the same way. Both are free, and both support export to HTML and PDF.
HackMD is another web-based tool, also free, which has collaborations options.

If you prefer working in a desktop application, there are also many options. Here is a nice write up of several Markdown Editors.

Learning the Syntax

After choosing your editor, you need to get familiar with some basic syntax. The most common and helpful Markdown syntax is very easy to master. You saw bold, italics, and a Markdown link earlier. Here are a few more examples:

Headings

To place a heading in the document, precede the text for the heading with one or more hashtags. Here’s a level two heading:

Level Two Heading

In Markdown, you would write it like this:

## Level Two Heading

Many Markdown editors also support the use of an id in a heading:

### Level Three Heading {#custom-id}

When converted to HTML, this will give you an anchor that you can use to link directly to that heading.

<h3 id="custom-id">Level Three Heading</h3>

Lists

Lists look much like they would in any other document. Here is a numbered list:

trumpet
french horn
tubal
trombone

which in Markdown is:

1. trumpet
2. french horn
3. tuba
4. trombone

and an unordered list:

cymbal
drum
marimba
tambourine
xylophone

looks like this in Markdown:

- cymbal
- drum
- marimba
- tambourine
- xylophone

Or you can use the single * with a space to make a list of items like this:

* string instruments
    * cello
    * violin
    * harp

Note the support for indenting lists using spaces in the example above, which would work with either * or -. The Markdown list above would render like this:

string instruments
- cello
- violin
- harp

Hyperlinks

To make a hyperlink in Markdown, you write a descriptive title in brackets, followed by the URL in parenthesis, as mentioned above. You can even save yourself the trouble of manually creating markdown links through the use of one of the many available browser extensions like this one for Chrome or this one for Firefox, which allow you to copy a website address as a Markdown link.

Rather than document the complete set of Markdown formatting options, I will refer you to the Markdown Basic Syntax Guide or in Markdown:

[Markdown Basic Syntax Guide](https://www.Markdownguide.org/basic-syntax/)

MultiMarkdown: An Expansion of the Language

The Markdown language is Open Source. Since its inception, other developers have enhanced the language to include options beneficial to academic writers. These include:

tables
blockquotes
citations
footnotes ^{[^1]}

Adding specific examples of these items is beyond this basic Markdown blog post. Instead, I recommend reviewing the MultiMarkdown v6 Syntax Guide. As you will see, the syntax for the new items follows the same spirit of being easy to add to a document and relatively intuitive syntax.

Advanced Tools and Applications

If you want to do a deep dive on Markdown, here are a few resources you can explore:

Pandoc: a universal convert that will convert a markdown file to dozens of other formats.
Mac Power Users #548: Jumping Into Markdown – Relay FM
Markdown Service Tools – BrettTerpstra.com
Markdown Tables generator – TablesGenerator.com
Setting Up a Scholarly Writing Environment With Markdown, VSCodium, and pandoc

Yes, But What Are the Cons?

You may recall that my colleague asked about the pros and the cons. So, as much as I love writing in Markdown, I should be transparent about the limitations I have encountered.

Collaboration. Both Microsoft Word and Google Docs support providing feedback on documents using the review or suggestion features. I have yet to find a Markdown editor that supports this type of collaboration. When I want to have a document reviewed, I convert the Markdown document to one of those other formats and then convert it back after implementing the feedback. Converting from Markdown to something, as I have said, is something most markdown editors already do. Converting from some other format to Markdown may take more effort. In this case, I used a Google Doc add-on, Docs to Markdown.
Citation tool support. When writing in academia, I use an integrated tool for citation. Zotero, when installed as an add-on to Word or Google Docs, will help generate bibliographies and inline citations. I have managed to integrate Zotero integrations into my Markdown editor of choice (Visual Studio Code), but it was very fiddly. I followed the setup described in this video: Setting Up a Scholarly Writing Environment With Markdown, VSCodium, and Pandoc. Not for the faint of heart, with a very detailed how-to, step-by-step video, it still took me the better part of a Saturday, with reasonably in-depth knowledge of Markdown, Zotero, and my editor.

Conclusion

To begin your Markdown journey, I suggest starting here: Markdown Guide. The easiest way to learn Markdown is to start using it; you can learn the basics in minutes. Once you do, you will find broad application and support. You can use Markdown to write HTML, draft blog posts, create documentation, and post messages on messaging platforms or forums such as Reddit, Discord, and GitHub.

^{[^1]}: It seems worth mentioning, in a footnote, that I wrote this blog post entirely in Markdown. Feel free to download it and take a look. To see it with the formatted HTML, try pasting it in the online markdown editor Dillinger.

In your work as an instructor or instructional designer, what kinds of course design problems have you been trying to solve lately? Perhaps there’s a discussion board assignment that you’d like to make more engaging, or maybe there’s a lab activity that students struggle with.

According to recent research findings published in the journal Nature, “…people are more likely to consider solutions that add features than solutions that remove them, even when removing features is more efficient” (Meyvis, T. and Yoon, H., 2021). In a course design context, this means we will probably reach for something we can add to our course to fix a problem: a shiny new tool we learned about at a conference, an extra video lecture, or an additional step for that lab activity that students struggle with. We do need to include quality tools and fresh media to our courses, certainly. However, because there is so much to cover in any given course, we should strategically subtract all unnecessary elements. The aforementioned Nature article has brought to my attention that I may be regularly neglecting the powerful design move that subtraction offers. As a result of reflecting on that, I’ve collected a few examples of how instructors and instructional designers can use subtraction in course design.

Subtraction example #1: Remove formal requirements from informal practice activities

Let’s take a look at a discussion board assignment as an example. Sometimes discussion boards are treated more like formal writing opportunities than discussions. For example, do you require students to not only respond to the prompt but also use a formal style of discourse and cite evidence in accordance with APA style guidelines and do so in a certain number of words? We don’t require students to use APA style or converse with a word count in our in-person discussions, so why would we do this in an online course (Darby, 2020)? Consider subtracting those formal writing requirements for discussion boards, and reserve the APA citations and formal requirements for polished writing assignments. That way, online discussions can be a place to practice and informally grapple with new concepts and ideas the way that face-to-face discussions are. Then, after students have a chance to work through topics in an informal way, they will be ready to try more formal tasks on the topic, such as constructing an argument and appropriately citing evidence according to a particular style guide.

Subtraction example #2: Reduce the frequency of office hours

If you hold office hours at a set time each week, and you notice that few students attend, consider doing away with the set weekly “office hours” altogether. Instead, invite students to make an appointment with you at least once during the term, at a time and in a modality that works well for them, or reduce the frequency of office hours to two or three timely sessions (optional attendance) per term, such as before each exam. Take questions in advance so that students too busy to attend can still benefit from the sessions, and post a recording of the session afterward in an announcement. According to Lowenthal, Dunlap, and Snelson (2017), less frequent but more focused office hours increased participation from students. Lastly, consider renaming your new infrequent office hours to something warm and inviting, such as “Coffee Break” or “Consultations” (Darby, 2019), which students may find more welcoming. Building in plans for facilitation and instructor presence in the early stages of course development allows faculty to focus more on teaching while the course is running and less on reactive problem solving.

Subtraction example #3: Dethrone teaching “folklore”

Teaching “folklore,” which John Warner calls the ineffective “practices handed down instructor to instructor” (p. 207, 2020), shows up uninvited, particularly when you have been assigned a course to teach that you had no hand in developing. One example of teaching folklore is the stubborn assumption that serious scholars are gatekeepers for their fields. Evidence of this exclusionary approach may show up in the form of a stern, overly formal, or cold tone in a syllabus. Consider removing verbiage that conveys a cold tone, since we now know that warm-tone syllabi encourage students to reach out to their professors (Gurung and Galardi, 2021). Another example of this is inflexible class “policies” that reflect an individual instructor’s preferences and not university policies. Consider reviewing the policies stated in the syllabus and delete any that are not aligned with actual university policies. Further, the idea that students must achieve a level of eloquence and scholarly sophistication on par with faculty in order to be considered for a grade of “A” on an assignment is another example of this. Evidence of this type of folklore could be found in rubrics with benchmarks that are nearly impossible to achieve. The element that could be subtracted here is not the rubric, but rather the specific language in the rubric that makes it impossible for students to succeed in the assignment. N euromyths, which are false beliefs about the brain and learning, could also be included in the category of teaching folklore. If you spot neuromyths in a course, remove them. In summary, if you spot one of these ineffective teaching folklore elements in your course, consider removing the “folklore” item.

For this design challenge, try subtracting ineffective design elements before adding new items to solve course design problems. If you are unsure if something should stay or go, ask yourself what purpose this element serves in the course. It should then become clear whether the item belongs or needs adjustment. Even small adjustments can transform learners’ experiences. What have you removed from your course? Share how the process was for you by leaving a comment.

References:

Blum, S. D. (Ed.). (2020). Ungrading : Why rating students undermines learning (and what to do instead). West Virginia University Press.

Darby, Flower. The Secret Weapon of Good Online Teaching: Discussion Forums 6 ways to lead meaningful class discussions in an asynchronous online forum. August 24, 2020.

Darby, Flower, and James M. Lang. Small Teaching Online : Applying Learning Science in Online Classes, John Wiley & Sons, Incorporated, 2019. ProQuest Ebook Central, http://ebookcentral.proquest.com/lib/osu/detail.action?docID=5780349.

Created from osu on 2022-01-18 23:50:41.

Gasiewski, J.A., Eagan, M.K., Garcia, G.A. et al. From Gatekeeping to Engagement: A Multicontextual, Mixed Method Study of Student Academic Engagement in Introductory STEM Courses. Res High Educ 53, 229–261 (2012). https://doi.org/10.1007/s11162-011-9247-y

Gurung, R. A. R., & Galardi, N. R. (2021). Syllabus Tone, More Than Mental Health Statements, Influence Intentions to Seek Help. Teaching of Psychology. https://doi.org/10.1177/0098628321994632

Lowenthal, P. R., Dunlap, J. C., & Snelson, C. (2017). Live synchronous web meetings in asynchronous online courses: Reconceptualizing virtual ofﬁce hours. Online Learning , 21 (4). https://doi.org/10

Meyvis, T. & Yoon, H. (2021). Adding is favoured over subtracting in problem solving. Nature.

Shi, T. Debunking Neuromyths and Applications for Online Teaching and Learning: Part 1. February 13, 2019. Ecampus Course Development and Training Blog.

Warner, J. “Wile E. Coyote, the Hero of Ungrading” from Chapter 13 of Ungrading.

clipboard, green apple, notebook, hand writing with pencil, scissors and spool of thread emojis used in module items

What should you know about emojis if you plan to use them in your online courses? Not being an extremely online person and not, perhaps, of the right generation, I came to emojis later than others and felt uncertain using them. What did these symbols communicate to others, and how would it reflect on me if I used them in my work with instructors and students? Without research-based answers to these questions, I nonetheless began using emojis in online course designs for the purpose of visual wayfinding and for fostering a friendly, playful tone. After several terms of using emojis in this way, I wondered whether they were accomplishing my goals. Now I’d like to share the background on emojis I’ve researched—and wish I had had earlier—so that you can avoid any missteps.

Wayfinding

Using emojis in the Canvas Modules menu (which doesn’t otherwise permit any modification of its visual design) has been one way to increase the salience of certain items or to lend them a certain skeuomorphism. With ‘at-a-glance’ speed—faster than reading text—students can quickly identify their intended navigational path once they’ve grasped the symbolism of each emoji. I use these symbols consistently for assignments of the same type across weekly modules. Here’s how the emojis looked in a graphic design course, which itself featured a lesson on semiotics and the way icons, indexes, and symbols operate as visual shorthand:

There are 6 module items arrayed one on top of the other in a list. Each item title has a number, a distinct emoji, and a text-based title. The emojis used are a clipboard, green apple, notebook, hand writing with pencil, scissors and spool of thread.

All the emojis chosen for this course reference the domain of school or making—a scissors represents creative assignments, a spool of thread winks at the idea of “threads” in a discussion. The usage of emojis, along with other design choices related to page layout and color scheme, was a way to model the design skills being taught. Students could thus experience how thoughtful design influenced their interactions with a digital product, in this case, a college course.

Tone

I had also hoped that using emojis would communicate to students that a course was welcoming, approachable, and not all deadly serious. Much research has been done to understand how the set of emojis depicting faces influences the emotional reception of text-based messages, but my course designs have generally used non-face emojis. Research on this set of objects, the meaning and emotional valence of which might be more opaque, also shows that emoji objects communicate positive affect or playfulness, perhaps because they demonstrate that the user has invested care and emotion work in choosing an emoji appropriate for interpersonal exchange (Riordan, 2017). Whether that is appropriate within online learning is less clear; emojis were found to increase students’ perception of how caring an instructor was, but they also led students to perceive the instructor as less competent (Vareberg and Westerman, 2020). And while they might “lighten the mood,” emojis were considered inappropriate in contexts that students considered formal, such as email (Kaye, et al., 2016). Within the domain of commerce, emojis in ads were pleasing to customers when the product was perceived as hedonic rather than utilitarian, suggesting again that context is a critical factor in emoji’s reception. Another consideration to have in mind is the multiplicity of interpretations an emoji might have at the intersection of gender, language, culture, etc. (Bai, Qiyu, et al., 2019), and how that will affect your intended tone.

Considerations with Accessibility

In testing my emojis in Canvas, I relied on ReadSpeaker TextAid; this accessibility tool simply skipped emojis and read only the surrounding text aloud – which was fine, as the critical content I wanted to communicate was in text form, and the emojis were essentially decorative. Unfortunately, after reading a great post on the experience of emojis for individuals with sight impairments who use assistive technology, I discovered that the ReadSpeaker TextAid behavior wasn’t typical. Using screenreaders more commonly used by individuals with sight impairments, I then confirmed that when emojis are encountered, their official names are, indeed, read aloud. This means that my visually clever discussion title was now rendered in speech as ‘2.6 Spool of Thread Discussion,’ lengthening the time it took to get to the useful information and adding irrelevant content. Whereas an emoji can be hidden from assistive technology via html on a Canvas page or assignment, there is no mechanism to do this within the title of a page or assignment. This means that, if an emoji is a must-have, it should be placed at the end of the Canvas item title, where it will be read last and prove less bothersome to learners using screenreaders. For me, however, this creates a jagged, irregular visual appearance when viewed in the Canvas Modules menu, and coming at the end of the title, makes the emojis a less useful navigational shortcut for sighted students.

Emojis appear at the end of each module item in a list of six. Each item title has a different length, so the emojis appear at different distances from the start of each line.

For tips on accessible emoji use, you should read Emojis: Readibility Guidelines and “Do Emojis and Accessibility Work Together?”. If you need to identify an emoji’s official title as read by a screenreader, consult the emoji’s entry in emojipedia.org, which will also show you the varied appearances an emoji takes on different platforms—another consideration you’ll need to have in mind.

Is the Party Over? 🎉

Unfortunately, with this research in mind, I can no longer sprinkle emojis throughout my Canvas courses like so much happy confetti. Now, I’ll recommend to the instructors I partner with that they use emojis sparingly, for the purposes of communicating the emotional valence of a message (to ‘smooth out the rough edges of digital life,’ as so incisively put by Stark and Crawford, 2015) or to increase salience, but always in accessible ways, and always with a few caveats in mind.

References

Aitchison, Suzanne. “Accessible Images, Icons and Emojis.” Up Your A11y.

Bai, Qiyu, et al. “A Systematic Review of Emoji: Current Research and Future Perspectives.” Frontiers in Psychology, vol. 10, Frontiers Research Foundation, 2019, pp. 2221–2221, doi:10.3389/fpsyg.2019.02224. Full Text.

Content Design London. “Emojis.” Readability Guidelines.

Finke, Beth. “Emojis and Accessibility: The DOS and Don’ts of Including Emojis in Texts and Emails.” Easterseals Blog.

Kaye, Linda K., et al. ““Turn That Frown Upside-down”: A Contextual Account of Emoticon Usage on Different Virtual Platforms.” Computers in Human Behavior, vol. 60, Elsevier Ltd, 2016, pp. 463–67, doi:10.1016/j.chb.2016.02.088. Full Text.

Mace, Di. “Do Emojis and Accessibility Work Together?” Blueprint – Blog by Tiny.

Riordan, Monica A. “Emojis as Tools for Emotion Work: Communicating Affect in Text Messages.” Journal of Language and Social Psychology, vol. 36, no. 5, SAGE Publications, 2017, pp. 549–67, doi:10.1177/0261927X17704238. Read via OSU Library.

Stark, Luke, and Kate Crawford. “The Conservatism of Emoji: Work, Affect, and Communication.” Social Media + Society, vol. 1, no. 2, SAGE Publications, 2015, p. 205630511560485, doi:10.1177/2056305115604853. Full Text.

Vareberg, Kyle R., and David Westerman. “To: -) Or to ☺, That Is the Question: a Study of Students’ Initial Impressions of Instructors’ Paralinguistic Cues.” Education and Information Technologies, vol. 25, no. 5, Springer US, 2020, pp. 4501–16, doi:10.1007/s10639-020-10181-9. Read via OSU Library.