Skip to content

Notification Documentation#320

Merged
TylerPachal merged 1 commit intocommanded:masterfrom
TylerPachal:notification-docs
Mar 2, 2026
Merged

Notification Documentation#320
TylerPachal merged 1 commit intocommanded:masterfrom
TylerPachal:notification-docs

Conversation

@TylerPachal
Copy link
Contributor

Adds moduledoc to some of the EventStore.Notifications.* modules. Some existing documentation was in place, but I added fully qualified module names in the documentation so that its easier to build the bigger picture of how the notifications work. In addition for this being nice for us humans, I think it will be useful for Claude to gather context.

In other projects, I have seen Claude perform much better when it can learn from in-module documentation (as opposed to top-level guides).

@@ -1,11 +1,11 @@
defmodule EventStore.Notifications.Listener do
@moduledoc false
@moduledoc """
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Annotation: Added some key tems like GenStage and full module names.

Comment on lines +1 to +4
defmodule EventStore.Notifications.NotificationTest do
use ExUnit.Case, async: true
doctest EventStore.Notifications.Notification
end
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Annotation: I didn't see any unit tests for this module so I added the doctest to have something in place.

@TylerPachal TylerPachal merged commit be0b4b5 into commanded:master Mar 2, 2026
0 of 5 checks passed
@TylerPachal TylerPachal deleted the notification-docs branch March 2, 2026 14:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants