Contributing to html2rss
We’re thrilled that you’re interested in contributing to html2rss
! There are many ways to get involved, and we welcome contributions of all kinds.
Code of Conduct
Before you begin, please read our Code of Conduct. We expect all contributors to adhere to this code to ensure that our community is a welcoming and inclusive space for everyone.
How to Contribute
Here are some of the ways you can contribute to the html2rss
project:
1. Create a Feed Config
Are you missing an RSS feed for a website? You can create your own feed config and share it with the community. It’s a great way to get started with html2rss
and help other users.
The html2rss “ecosystem” is a community project. We welcome contributions of all kinds. This includes new feed configs, suggesting and implementing features, providing bug fixes, documentation improvements, and any other kind of help.
Which way you choose to add a new feed config is up to you. You can do it manually. Please submit a pull request!
After you’re done, you can test your feed config by running bundle exec html2rss feed lib/html2rss/configs/<domainname.tld>/<path>.yml
.
Preferred way: manually
- Fork the
html2rss-config
git repository and runbundle install
(you need to have Ruby >= 3.3 installed). - Create a new folder and file following this convention:
lib/html2rss/configs/<domainname.tld>/<path>.yml
- Create the feed config in the
<path>.yml
file. - Add this spec file in the
spec/html2rss/configs/<domainname.tld>/<path>_spec.rb
file.
RSpec.describe '<domainname.tld>/<path>' do
include_examples 'config.yml', described_class
end
2. Improve this Website
This website is built with Jekyll and is hosted on GitHub Pages. If you have any ideas for improving the documentation or the design, we’d love to hear from you.
Find the source code on GitHub
3. Host a Public Instance
The html2rss-web
project is a web application that allows you to create and manage your RSS feeds through a user-friendly interface. You can host your own public instance to help other users create feeds.
Learn how to host a public instance
4. Improve the html2rss
Gem
Are you a Ruby developer? You can help us improve the core html2rss
gem. Whether you’re fixing a bug, adding a new feature, or improving the documentation, your contributions are welcome.
Check out the documentation for the html2rss
Gem
5. Report Bugs & Discuss Features
If you’ve found a bug, please open an issue on the appropriate GitHub repository. For new feature ideas, we encourage you to start a discussion first.
Report Bugs:
Discuss Features:
We appreciate your interest in contributing to html2rss
!