RunestoneInteractive / RunestoneInteractive/rs

Scratch activecode starter code

Open
#587 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
69
Forks
117
Avg merge
6d 4h
Merged PRs (30d)
24

Description

For languages like Java or C++, significant boilerplate code is needed to test out a chunk of code. This makes the Scratch activecode harder to use if I want to say test out a string function's behavior.

For books using those languages, it would be useful if there was already a main function (C++) or a class with a main function (Java) so that the reader could just focus on adding the code they want to test.

Issues / options:

  1. The desired starter code might differ from book to book. Should the starter code be something that gets specified by a book author? Or at least a way to override whatever the default is?

  2. An author might want to provide a few different "templates". In C++, I could see wanting one template that has a main function and another that sets up a simple unit test. This feature might also be useful in a language like Python - in a book that made heavy use of turtle graphics or media processing, the author might want to provide templates with the necessary setup code for those environments. Perhaps an author could describe environments with a title and some starter code and a drop-down would allow the user to pick a template.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files, tests, or entry points are named in the issue. Start by locating the Scratch activecode implementation and how books currently configure activecode; clarify whether authors should provide one starter program or selectable templates for languages such as Java, C++, and Python. Done should include a decided configuration approach and working author- or book-specific starter templates.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp, java, python
Domain
tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.