Thank you for sharing Julian.
My comment for the meeting would also have been related to tutorials. More specifically, I feel it would be nice to have a page describing GitBuilding overall; so that users can get a sense of the “big picture” and flatten the learning curve a bit.
In summary, it is not entirely clear to me how GitBuilding is meant to be used, and workflow examples for new users starting new projects would be welcome.
My general feeling is that GitBuilding’s usage documentation offers thorough syntax and usage details first, without previously presenting an abstract overview of how it works.
After getting a basic bearing, I’d appreciate a description of the basic kinds of files and a directory structure for a GitBuilding project, syntax and linking examples based on those files, and workflow examples for projects at different stages of development.
For example, the getting started page is about syntax, but without context: which file is being edited? where is it? why it is being shown to me?. The getting started page prompts more questions than answers and, unfortunately, the full example linked at the end is mostly intimidating .
The documentation offers something similar to an overview diagram in the complex projects page, but it is a bit complex for new users.
To illustrate: whenever I start a new programming project, it is usually in R , and I always follow this directory structure and use RStudio projects. The recommended directory structure immediately reflects what an R workflow is all about. If you have this basic knowledge, getting started is a breeze.
I hope my comments are helpful. I am really grateful for your work on GitBuilding.