Skip to content
This repository was archived by the owner on Mar 5, 2025. It is now read-only.

Latest commit

 

History

History
32 lines (23 loc) · 1.29 KB

File metadata and controls

32 lines (23 loc) · 1.29 KB

Contributing to the Runestone Components

We welcome contributions through pull requests to the Runestone Components.

Understand the RoadMap

You should look at the development road map and especially RSE-0001 which gives you a clear idea of the current philosophy behind the components. Any Sphinx directives should create very simple html and let Javascript take care of the rest.

Coding Standards

  • All components must remain Python 3/2 compatible. The six module is already in the requirements.txt file, so feel free to use that.
  • No Tabs
  • Avoid profliferation of jQuery versions. Make your stuff compatible with the version of jQuery in the common folder.
  • Avoid proliferation of additional third party javascript modules. We are already out of control in this regard and it would be nice to rein it in.

Provide an example

The folder runestone/common/project_template/_sources folder is a great place to add a file that demonstrates your new feature or component in action.

In fact you should provide two examples whenever possible to demonstrate that you can have multiple instances of your component on a single web page.