@@ -12,7 +12,7 @@ It seems like a hassle and in fact, it _is_ a hassle. But documenting helps you
## Telling a Story
Documenting online is different from keeping notes in a paper diary. GitLab is a public space and everybody can see what you have uploaded. To do them (and yourself) a favor, you need to develop some storytelling skills. Sorry to break this news to you. But by bad or sloppy storytelling people will find your documenting boring and unimportant and also you will leave a none-too-professional impression, which is unjustified because you ARE a Fabricademy talent who is doing great work. So training yourself in better storytelling will do better justice to your talents and designs. Which, by the way, will also greatly improve your design efforts as well. Because good design is first and foremost a good story. How do you tell a good story? Be as specific and as personal as you can. Try to think of the reader as a good but critical friend you are talking to. Do not focus only on the how but also on the why - why do you think someting is interesting and important? Think of your documenting as a food blog: nobody wants to read just a list of ingredients and the recipe. People want to see the scrumptious meal, with tips about how and when to serve it, with some personal words from the cook and how her kids thought the recipe was yummy. Give examples from your own life. Be sure to upload nice images that show what you are writing about. Make jokes. Be light-hearted. And don't worry about your English. There is always the spelling corrector and Googe Translate! As an example of storytelling, and also to practice my GitLab content management system-skills, I have done some documentationg below about quilts.
Documenting online is different from keeping notes in a paper diary. GitLab is a public space and everybody can see what you have uploaded. To do them (and yourself) a favor, you need to develop some storytelling skills. Sorry to break this news to you. But by bad or sloppy storytelling people will find your documenting boring and unimportant and also you will leave a none-too-professional impression, which is unjustified because you ARE a Fabricademy talent who is doing great work. So training yourself in better storytelling will do better justice to your talents and designs. Which, by the way, will also greatly improve your design efforts as well. Because good design is first and foremost a good story. How do you tell a good story? Be as specific and as personal as you can. Try to think of the reader as a good but critical friend you are talking to. Do not focus only on the how but also on the why - why do you think someting is interesting and important? Think of your documenting as a food blog: nobody wants to read just a list of ingredients and the recipe. People want to see the scrumptious meal, with tips about how and when to serve it, with some personal words from the cook and how her kids thought the recipe was yummy. Give examples from your own life. Be sure to upload nice images that show what you are writing about. Make jokes. Be light-hearted. And don't worry about your English. There is always the spelling corrector and Googe Translate! As an example of storytelling, and also to practice my GitLab content management system-skills, I have done some documentating below about quilts.
