Home

Welcome to the Primrose wiki!

We'll be marking issues and documents with labels. Issues will be marked as:

• first-timers-only: Please leave these issues for people just getting started in programming and working with Git, they are simple things more focused on teaching the process of using the various tools. They are usually one-line-of-code changes, with that line completely described within the issue ticket. It will typically be changing a static value of some kind.
• easy: Please leave these issues for beginners who have already gotten through the "first timer" process and now need practice writing real code. They will only be a few lines of code to complete the change, and the change will be completely described.
• medium: These are real issues that need to be addressed, not just practice issues, where we know that the implementation is straight forward, but it's more effort than the easy issues that are only a few lines of code. The purpose of the task will be clearly described, and a suggested path for implementation the change will be described, but the step-by-step process of implementing the change will be left to the developer taking on the task.
• hard. These are also real issues, but we don't yet know what the implementation will be, as we haven't researched the issue yet. hard issues are somewhat like TODO items for researching the issue and breaking it down into a series of medium issues.

Documents will similarly be marked:

• first-timers for anyone just opening a source code editor for the first time,
• beginners for anyone who is a little familiar with the steps of writing code but is still in the process of learning programming, and
• experienced for everyone else.

Even if you're experienced, you may still want to skim the beginners documents, just to make sure we're all on the same page regarding setup.

First Timers

If this is your first time here and you're interested in becoming a contributor, please check out Welcome to Primrose.

If you are looking for information on how to get started working on open source, JavaScript projects like Primrose, check out the Prerequisite Tools. After that, read Working on Primrose to help get setup on using and working on Primrose. Then, find one issue in the Issue's list for first-timers-only, complete it, Submit a Pull Request, and officially graduate to Beginner!

Beginners

People who have already used Git, installed a text editor, and written a small amount of code probably want to jump straight to Working on Primrose. There are a number of issues marked easy waiting for you to get to work.

Experienced

Finally, if you're confident with your tools and are just looking to jump into the deep end, look at the Project Structure for help in figuring out how all the pieces fit together, and the Project Road Map to get an idea of where things are going. Any issue marked medium is up for grabs. That's not to say you're not allowed to try to address the hard issues, just that the hard issues are marked as such because we haven't yet done the work to figure out what is causing the issue and/or what needs to be done to resolve the issue yet.