Hello @wyardley A new version of the Slack Orb has been published. Reviewing PRs may take some time for the next month during the Hacktoberfest event. There are a lot of participants and just a few of us, but we will get to all submissions in a timely fashion.
In the future all PR’s will result in automatically releasing new Orb versions but that pipeline design is still a work in progress.
There is no automatic generating of the Readme files for orbs by default. Orbs documentation is automatically generated on the Orb registry page for that orb.
I’m aware of the autogenerated docs on the registry.
Readme files in the orb’s code repository should ideally contain information to help contributors begin to collaborate on the orb.
That would make more sense; currently, though, the checklist requests that all parameters be documented in the README as well, which, from what I can see, seems to result in some drift. So maybe it would make sense to either figure out a way to generate the markdown docs as well, or else pull out the user docs from the README and just provide instructions for contributing and a link to the generated docs?
Would you mind providing a link to this checklist? We may have some older documentation floating around but at the moment I do not believe we have any live suggestions for readme files. Orb author best practices can be found here: https://circleci.com/docs/2.0/orbs-best-practices
We’ll take a look at the checklist and either update, remove, or integrate it into this best practice page.
when do new releases get cut? i was about to make a PR to add the channel override setting but I see it was already added and merged a few days ago. Is it a manual trigger to make a new version? Can someone push that button please?
I get an error when I try to set the channel: variable on the approval-notification job in 3.4.0. I was hoping 3.5.0 would’ve been released before the weekend but I’ll look for it again on monday at this point.
Sorry for the delay, with Hacktoberfest this month we are at limited capacity across all of the incoming updates. The Slack orb is meant to be on an automated release that may not be functioning properly at the moment (it is one of our first orbs). I’d like to investigate this and manually push the update for you all. Would you mind linking to the PR/Feature you were looking to have added so I can trace back the issue with our release process? Thank you.
Thank you for your patience. Version email@example.com has been released. There will need to be additional changes made to the development pipeline as I believe this release should have resulted in a minor change, not a patch. I do not believe anyone should be negatively affected but please feel free to share any and all feedback.