Beyond the individual item types, there are a few things you will need to be familiar with in teach related to assessment.
We have created a specific item writer training pool so you can practice working with teach without impact a live assessment. You will be given access to this pool around the time of the teach specific onboarding. If you don’t have access, let the team know and they will add you. The master branch includes items that can be used as templates for a range of different things you may want to do in items.
Creating a new branch
When you create a new branch the first build will always fail. This is nothing you have done wrong, its related to the underlying build systems. Go into the builds tab and press “Manual Build”. This second build should now be successful.
Note that you will not be able to preview any items with the preview button until you have had a successful build on your new branch. Be patient and wait for a good build before you start to save new items, if you don’t it will be harder to debug the problem.
Using Data and Images
Data in items should not be large. Test takers never see the data, so it only needs to be big enough to test the concept. You shouldn’t feel the need to come up with new data for every item that you write, feel free to create a selection of items related to the same data, just remember that items should be independent and ideally no item should give away the solution to another item.
We ask that you do not use data that is used in other DataCamp content that teach the same ideas. We want to test competency not the ability to remember previous content. The same goes for commonly used data. We should always have the right to use the data too, for ease we ask that you stick to open data. For many assessment items we simply invent a few rows of data. This allows us to easily make adaptations to test specific concepts.
If you are using the same data in a number of items, you may want to upload a file to teach that you can then import in the pre-challenge code. To do this, go to the “Assets” tab. You can then use the interface to upload a file. There are size limits, but for assessment you shouldn’t be reaching these limits - if you are you need to cut the size of the data. We recommend uploading a file with a maximum of 100 rows in csv format. Let us know if you need to do something different.
When you add a file, it will have a unique URL that you will need to use to reference it. This URL should never appear to the test taker. Always load the file in the pre-challenge code. If you need to include the file URL in the item, let us know and we will work with you on approaches to handling that situation.
The same process is used to upload images that you may need to use in the context. Remember to keep the file small. We recommend using jpeg files but other formats are permitted.