Part of being a great Sitecore developer means that you keep the content authors in mind. We want to make their experience as easy and intuitive as possible. One way to do this is to add helpful annotations to specific item fields. This helps the author understand what the field is used for or if there are any ambiguities about the field itself that are valuable to know of (ex. if the field value may affect the way the page will look).
Every template field item has a set of fields inside related to "Help":
However, there is a Sitecore bug where if you put quotations in the fields, particularly the "Short Description" field, it will break your Experience Editor:
Simply remove the quotations, tell you your team never to do this, and keep on developing!
Good luck out there,
Ryan & Marcel
Ryan Allan
Senior Developer
Ryan is a seasoned Senior Developer at Fishtank and is Sitecore Developer Certified. In a nutshell, he describes his role as "building extremely fancy websites". Ryan has a degree in Mechanical Engineering and previously worked on power plants and compressors, and now builds websites for the same company as a client! Outside of work, his interests are science + physics and spending time with his kids.