The Project Notes feature is a way for Scratchers to type documentation that goes with their projects for other Scratchers to see and understand what the project is about. They are separated into two sections, the "Instructions," and the "Notes and Credits." Only the sharer of a project or member of the Scratch Team can edit the project notes. This is to avoid false information and to ease the project's owner. Project notes can be found on the right of a shared project's page.
There are two sections to the project notes.
Project Instructions is a place where one can put instructions to their game. It is also a common place to put an advertisement, the current version number of the project, and an introduction to the project.
Notes and Credits
Notes and Credits was a section added in Scratch 2.0 to allow Scratchers to give credit to where it is deserved. It is also used to add side notes on a project, and this is the only section shown if the project was created before Scratch 2.0.
Project notes can only be typed online at the moment.
Online editing can only be done one way: Clicking the project notes area on a project's page. A text box appears, and text can be inserted. However, many users have complained of the small space to write their text in—some instead type in a word processor and paste the text.
If you give a link to a project, forum thread/post, studio, or wiki article in some project notes, it comes up as a link which says (link to project), (link to forums), (link to studio), or (link to wiki) respectfully. This makes it easier to make sense of links in the project notes. This can also be used with usernames, so @user will become a link. This can also be done in comments.
Project notes are generally used for explaining information about their project. Some examples of uses are:
- Explaining how to use the project
- Saying what the project is about
- Showing the current version number of the project
- Announcing how long the project took to make
- Explaining what the project does
- Giving credit to people who may have helped with the project
- Saying how the project was made, providing extra information and documentation, and links for further reading
However, Project Notes are also used in other ways, such as:
- Giving information about the user who shared the project
- Asking people to view other projects of the user
- Telling people that a download is necessary
- Telling people what projects the creator of the project is currently working on
There are also other multiple ways the Project Notes are used for, but there are too many to list all of them here.
Changing the Default Project Notes
By default, the Project Notes in a Scratch project are blank. If you want to provide questions or instructions whenever users first edit a project’s notes, you can create a default Project Notes file. Simply make a text file with your default notes, save it with UTF8 encoding, name it "defaultNotes.txt", and put it into the Scratch folder.
In Scratch 1.x there was only one section called "Project notes." It could be edited when you uploaded a project from the editor as well as online.