Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Increase details of Channels documentation #236

Merged
merged 1 commit into from
Jul 19, 2024

Conversation

oxzi
Copy link
Member

@oxzi oxzi commented Jul 12, 2024

With a release approaching, the Channels documentation got more information about how the Channel system actually work and how to build your own channels.

The internal/changes/examples JSON files were inlined to ease the readability and updated, as they contained partially outdated information.

For the pkg/plugin part, some API documentation was added as this might get used by external users.

@oxzi oxzi added enhancement New feature or request doc Documentation related labels Jul 12, 2024
@oxzi oxzi requested review from julianbrost and yhabteab July 12, 2024 11:58
@cla-bot cla-bot bot added the cla/signed CLA is signed by all contributors of a PR label Jul 12, 2024
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
pkg/plugin/plugin.go Outdated Show resolved Hide resolved
pkg/plugin/plugin.go Outdated Show resolved Hide resolved
@oxzi oxzi force-pushed the docs-10-Channels-details branch from 84fa53b to 18cfa4d Compare July 12, 2024 13:48
@oxzi oxzi requested a review from julianbrost July 12, 2024 13:49
@oxzi oxzi force-pushed the docs-10-Channels-details branch from 18cfa4d to e4e6837 Compare July 12, 2024 13:51
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
pkg/plugin/plugin.go Outdated Show resolved Hide resolved
@oxzi oxzi force-pushed the docs-10-Channels-details branch from e4e6837 to 17cb89f Compare July 12, 2024 14:55
@oxzi oxzi requested a review from yhabteab July 12, 2024 14:55
@oxzi oxzi force-pushed the docs-10-Channels-details branch from 17cb89f to d021ef1 Compare July 15, 2024 07:16
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
@oxzi oxzi force-pushed the docs-10-Channels-details branch from d021ef1 to f2f3ca7 Compare July 15, 2024 08:47
@oxzi oxzi requested a review from martialblog July 15, 2024 08:49
@oxzi oxzi force-pushed the docs-10-Channels-details branch 3 times, most recently from 6fbc306 to a88356d Compare July 15, 2024 10:00
@oxzi oxzi force-pushed the docs-10-Channels-details branch from a88356d to 80f5cb5 Compare July 15, 2024 12:54
@oxzi oxzi marked this pull request as draft July 16, 2024 07:57
@oxzi oxzi force-pushed the docs-10-Channels-details branch from 80f5cb5 to 2930520 Compare July 16, 2024 09:03
@oxzi oxzi marked this pull request as ready for review July 16, 2024 09:05
@oxzi
Copy link
Member Author

oxzi commented Jul 16, 2024

I reworked some parts, especially to mention changes from #206. Furthermore, I described how the channel configuration through the two RPC methods works and how a channel plugin is expected to behave. As the documentation links to the Go API doc, I added more API docs for the fields.

Please take another look.

doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
doc/10-Channels.md Outdated Show resolved Hide resolved
@oxzi oxzi force-pushed the docs-10-Channels-details branch from 2930520 to e833633 Compare July 16, 2024 11:49
@oxzi oxzi requested a review from yhabteab July 16, 2024 11:49
With a release approaching, the Channels documentation got more
information about how the Channel system actually work and how to build
your own channels.

The internal/changes/examples JSON files were inlined to ease the
readability and updated, as they contained partially outdated
information.

For the pkg/plugin part, some API documentation was added as this might
get used by external users.
@oxzi oxzi force-pushed the docs-10-Channels-details branch from e833633 to 42ad233 Compare July 16, 2024 12:03
Copy link
Member

@yhabteab yhabteab left a comment

Choose a reason for hiding this comment

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

LFTM!

@julianbrost
Copy link
Collaborator

@martialblog Do you want to have another look as well, i.e. should I wait with merging this a bit?

@julianbrost julianbrost merged commit f0e9515 into main Jul 19, 2024
12 checks passed
@julianbrost julianbrost deleted the docs-10-Channels-details branch July 19, 2024 08:38
@martialblog
Copy link
Member

@julianbrost Thanks, I was away these last days. If I find something I'll just open a PR.

Looking forward to v0.1.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cla/signed CLA is signed by all contributors of a PR doc Documentation related enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants