You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I updated my CLN installation after experiencing channel connection issues on the previous version - and due to there not being native arm64-musl (Alpine, OpenWrt) packages, I compile from source, on a specified tag.
Upon startup, I discovered log lines about plugin-clnrest.py not finding some of the required dependencies, which prompted me to look at the changelog and saw a mention of a Pull Request, which pointed to a closed Pull Request with no further documentation.
Long story short: Whilst the commit history shows updated docs, it isn't immediately apparent, requires through digging from link to link and reading commit messages themselves, possibly the included changes, to even know what this is, what it implements exactly, which plugins it potentially replaces or deprecates and alike.
Sorry if this come across as annoyed or such but this is a great example of how not to document. :)
Thus, I'd like for the changelog to be updated with a link pointing properly at the new plugin documentations.
We try to add as much information as possible on our release notes but the last release had so many important features that we were unable to list them all. That is also a main reason to add detailed list of change logs.
Apart from that, we post a detailed release blog on blog.blockstream.com for people who want to get more details about the release. However, due to the size of last release, blog has been divided in three parts this time. So clnrest was explained in the second part at https://blog.blockstream.com/core-lightning-v23-08-satoshis-successor-part-ii-developer-experience/.
Also, we maintain all documentation related to CLN at https://docs.corelightning.org/docs. And you can find clnrest related documentation at https://docs.corelightning.org/docs/rest and live test it at https://docs.corelightning.org/reference/post_rpc_method_resource.
Finally, clnrest fails gracefully if a dependency is missing and will not adversely effect the node.
Hope that these links will help. Closing the issue now. Thanks.
Hello!
Issue and Steps to Reproduce
I updated my CLN installation after experiencing channel connection issues on the previous version - and due to there not being native arm64-musl (Alpine, OpenWrt) packages, I compile from source, on a specified tag.
Upon startup, I discovered log lines about
plugin-clnrest.py
not finding some of the required dependencies, which prompted me to look at the changelog and saw a mention of a Pull Request, which pointed to a closed Pull Request with no further documentation.Long story short: Whilst the commit history shows updated docs, it isn't immediately apparent, requires through digging from link to link and reading commit messages themselves, possibly the included changes, to even know what this is, what it implements exactly, which plugins it potentially replaces or deprecates and alike.
Sorry if this come across as annoyed or such but this is a great example of how not to document. :)
Thus, I'd like for the changelog to be updated with a link pointing properly at the new plugin documentations.
getinfo
output(ps. No idea where
-modded
comes from... Imake distclean
'd before the build, then did the configure/make dance.)The text was updated successfully, but these errors were encountered: