Callysto
  • Introduction
  • Quickstart Guide
  • Preface
  • What is Computational Thinking?
  • Philosophy
    • Goals of the Callysto Project
    • Software tools - Eat Your Own Dogfood
  • Notebook Design
    • Notebook Format
    • Template
    • Notebook Reviewer's Guide
  • Development Team Structure and Process
  • Extensions
    • Notebook Binders, Pullers, and Viewers
    • Nbplus
      • Geogebra
  • Coding
    • Jupyter, Under the Hood
    • Best Practices for Code Development
    • Coding Mistakes to Avoid
    • Markdown Language
    • Bug Reporting
    • Github Workflow
    • Troubleshooting
  • Information Visualization
    • Plotting
    • Audio Generation
    • Animations - D3.js
    • Animations - HTML5
    • Widgets for Interactivity
  • Online Resources
    • Useful Links
    • Contacts
Powered by GitBook
On this page
  • Who can report a bug?
  • Internal
  • External
  • Where can they report a bug?
  • How to report a bug?
  1. Coding

Bug Reporting

Who can report a bug?

Internal

  • Cybera & PIMS

External

  • Callysto creator (content creator / curriculum expert - professor, teachers etc)

  • Callysto developer (Student developers)

  • End users - Students, Teachers

Where can they report a bug?

  • Internal bug tracking - JIRA.

  • External bug tracking - Bugs can be reported by creating an issue on the Github repo.

How to report a bug?

  • Three important aspects of bug reporting in general are:

    • Brief description of the bug, with steps on how to reproduce it.

    • Expected result

    • Actual result

  • When writing down the steps to reproduce a bug,

    • It would be helpful to note down the environment details like web browser or other system information if thats relevant. Also, note down general details like name of the notebook, section of the notebook where you find the error, etc.

    • Add screenshots if possible and only if it adds to the explanation. Please note, for external bug reporting, screenshot uploads are not available natively in Github, therefore you may want to consider hosting your image and linking to it via imgur or your host of choice.

PreviousMarkdown LanguageNextGithub Workflow

Last updated 4 years ago