Contribute

If you want to contribute your code, we always appreciate and promote it—you can contribute in the following ways.

Fork ClipBucket

Creating a fork is producing a personal copy of someone else’s project. Forks act as a sort of bridge between the original repository and your personal copy. You can read the complete documentation on forking.

Fork on GitHub

Want to create a plugin?

Creating plugins for ClipBucket is pretty easy—all you have to do is write your code, register your anchors, and your plugin is ready to use. See the plugin getting started guide. You can open a pull request with your plugin when it’s ready.

Fix an issue?

Issues are a great way to keep track of tasks, enhancements, and bugs for your projects. If you’ve fixed an issue or made a change that you feel would benefit the community as a whole, you should definitely consider contributing back. Create your pull request to fix the issue. For a reference guide, see GitHub’s creating a pull request documentation.

• If you make a pull request, do not create an issue—use the PR description for that.
• Issues are handled with a much lower priority than pull requests.
• Pull requests must be made against the correct version.
• The master branch maintains stable releases—make sure your change doesn’t hurt stability.

Report an issue?

If you think you need to report an issue, please consider the following points. Create a new issue on GitHub—current issues are here.

• Make sure you’ve actually read the error message if there is one—it may really help.
• No need to create an issue if you’re making a pull request to fix it. Describe the issue in the pull request; it’s the same as an issue, but with higher priority.
• Double-check that the issue still occurs with the latest version of ClipBucket.
• Search for similar issues before reporting anything.
• If you really think a new issue is useful, keep in mind that it will be treated with a much lower priority than a pull request or a ClipBucket Client Area ticket.

Having issues with installation?

Please see our server setup and script installation guide here.

License

ATTRIBUTION ASSURANCE LICENSE (adapted from the original BSD license) Redistribution and use in source and binary forms, with or without modification, are permitted provided that the conditions below are met. These conditions require a modest attribution to AUTHOR (the “Arslan Hassan”), who hopes that its promotional value may help justify the thousands of dollars in otherwise billable time invested in writing this and other freely available, open-source software.