On Tuesday, 14 January 2025 at 02:47:57 UTC, Steven Schveighoffer wrote:
> BEERCONF!
Beerconf this month will be held on January 25-26.
Just want to remind everyone that this is happening in 2 days!
A few months ago, we had a closefest for Phobos PRs, which was pretty successful.
This month, we're going to do a different exercise. One thing that makes it hard for users to pick up a language they are unfamiliar with or in the process of learning, and use a library they have not used before, is a lack of examples.
A suggestion from Andrea Fontana is that we have a "dlang community doc day 2025". Everyone while on beerconf should add an example to either one of your projects or a project you use that has few or no examples. I know I have at least 2 projects that this would apply to.
Note that examples in D are really easy -- just make a unittest with the example code in it. Then you ddoc comment that example, and it becomes a documented example for the item being documented, as well as an extra test for the code itself. This works for module declarations as well as types and functions.
So think of an example you can add to a project, and join in! Maybe we can all review it and try out the example.
See you then!
-Steve