Beerconf January

[Steven Schveighoffer]

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