# Contribute

## Yearn Community
Help build the future of finance, today. Shape your skills, help others and help grow the Yearn ecosystem. If it’s not fun, we’re not doing it right. If you are interested in finding out a bit more of what Yearn means for builders see the [Yearn manifesto](https://gov.yearn.finance/t/how-we-think-about-yearn/7137).

### Hackathons

Stay tuned to the official [Yearn Twitter account](https://twitter.com/iearnfinance) for any announcements for Hackathons where winners can win prizes voted by the community.

## How to Contribute

### Have an idea?

We are always open to new suggestions or better ways of doing things. If you have an idea feel free to use the appropriate channel on [Discord](http://discord.yearn.finance), [Reddit](https://www.reddit.com/r/yearn_finance/), or make a post on **[Yearn Governance - General Chat](https://gov.yearn.finance/c/general-chat/7)** to discuss. If the idea has been thorughly thought out, and is something that would be a change to one of the Yearn products, you can make a post on **[Yearn Governance - Proposals](https://gov.yearn.finance/c/proposals/5])** adhering to the **[Proposal Guidelines](https://gov.yearn.finance/t/proposal-how-to/106)** supplemented with any additional information you find adequate from **[YIP Template](https://github.com/iearn-finance/YIPS/blob/master/yip-X.md)**. You can see previous YIPs for guidance **[here](https://yips.yearn.finance/all-yip)**.

### File a Bug

If a yearn product isn't working like you think it should please visit the appropriate Github repository listed in the [General Resources](##general-resources) section below or search in the [Yearn Github Repo](https://github.com/iearn-finance/yearn-protocol) if the issue already exists. If it does not exist please create a new issue following the issue template present in the repository(repo). If no issue template is present please include enough information such as your browser version, device, etc for that project so that the developers can replicate it and fix it. If the issue already exists you can signal your support by adding a thumbs up to the already existing issue or add any additional helpful information.

### Leave Feedback
Currently we use [Canny](https://yearnfinance.canny.io/) to raise general feedback.

### Documentation

The Yearn ecosystem is expanse and the need to document it is ever growing. The Yearn Documentation can be seen at the official [Yearn Docs](https://docs.yearn.finance/) page and it includes everything from High Level Documentation regarding Yearn itself to more product specific and technical explanations.

Whether you are interested in writing *How To* guides on how vaults work for the layperson or creating diagrams on how the entire protocol ties together, there is something for everyone. If languages are your *forté*, then translations might be up your alley as Yearn wishes to reach everyone regardless of their native language.

You can see our ongoing progress on the [Github Project Board](https://github.com/orgs/iearn-finance/projects/2) where you can look through any issue which interests you. In order to begin contributing please see our [How to Use Github](https://hackmd.io/4U35op0ORoGT24lzPhbGNQ) guide and begin contributing by submitting a PR adhering to our [Writing Style Guide](https://hackmd.io/dXQecpkJQX6XRy4y7k7j3g).

We use use a combination of HackMD, Gitbook, and Github for our [Documentation](https://docs.yearn.finance/). In order to contribute to our diagrams & schemas we use [DrawIO](https://draw.io) in conjunction with Google Drive for versioning. If you are a grammar stickler you can see our [Reviewer Guide here](https://hackmd.io/juTKNn3xTpKJgFDo2AglLw).

You can also join us over at #documentation channel on [Discord](https://discord.com/invite/6PNv2nF) and introduce yourself.

If this is bit too confusing right now don't worry about it, please let us know what we can clear up and in the meantime you can begin contributing on those HackMD docs immediately from those Github issues and we'll guide you through the rest.

### Build

#### Developers

##### Protocol Contributors:
- [Developer Team List](https://docs.yearn.finance/additional-resources/team#protocol-and-development)

If you are a developer we need your help! Before you begin you can familiarize yourself with Yearn, its products, and its infrastructure by reading our [Documentation](https://docs.yearn.finance/).

You can additionally see our ongoing progress on our [Github Project Board](https://github.com/orgs/iearn-finance/projects/1) and you can immediately begin contributing where you see fit for anything that's tagged as `help wanted` as long as you stick to the respective repository's `Contribute` page with its coding guidelines (linting, formatting, PRs etc) It's that simple :slightly_smiling_face:. You can also join us over at the #dev channel on [Discord](https://discord.com/invite/6PNv2nF) if that's more your thing.

If you are interested in working on a particular project check out the list of Yearn products in the [General Resources](##general-resources) section below or if you want to directly check out our list of repos head on over to our [Docs: Code Repositories](https://docs.yearn.finance/developers/code-repositories).

If you want a general overview of how our various services interact with one another for Vaults please see the schema and accompanying descriptions at **[Vaults Overview](https://docs.yearn.finance/developers/yvaults-documentation/vaults-overview)**. For an interactive schema strategy take a look at [yDAI]() to see how all the pieces of the smart contracts work together.

If you are curious how **strategies** work, please check out **[ETHOnline 🛠️ Yearn Strats 101](https://www.youtube.com/watch?v=4gwZk-IaMRs)** from our Yearn Devs. To start writing a new Strategy of your own please visit **[Yearn Starter Pack Repo](https://github.com/iearn-finance/yearn-starter-pack)**.

If you are looking to integrate with Yearn please visit our **[Integration Guide](https://docs.yearn.finance/developers/integration-guide)** and make sure to check out our **[Interface Documentation](https://docs.yearn.finance/developers/yvaults-documentation/vault-interfaces)**.

Lastly, if there is something missing here that you think would make this better please create an issue here or submit a PR :)

#### Designers

If you are a UI/UX designer, animator, or graphic designer Yearn needs your help!

Whether it is creating graphics to describe how our the Yearn systems such as strategies work, making Yearn easier to navigate, or simply adjusting misaligned text on our homepage, we welcome all designers aboard the Yearn ship.

You can find us over on [Discord](https://discord.com/invite/6PNv2nF) at the #ui-ux channel and you can see our work log on our [Kanban Board](TODO: Create Design Project Board).

## Yearn Contributors

See our wonderful list of contributors and statistics of contributions to the Yearn ecosystem at [yContributors.finance](https://ycontributors.finance/). Get your name added to the list by contributing documentation, code, designs, or whatever you feel is necessary :)

## General Resources

### Yearn Products
- [Yearn.Finance](https://yearn.finance/)
- [Repo](https://github.com/iearn-finance/iearn-finance)
- [Yearn Governance](https://ygov.finance/)
- [Repo](https://github.com/iearn-finance/ygov-finance)
- [Yearn Insurance](https://yinsure.finance/)
- [Repo](https://github.com/iearn-finance/yinsure-finance)
- [Yearn Borrow](https://yborrow.finance/)
- [Repo](https://github.com/iearn-finance/iborrow-finance)
- [Yearn Swap](https://yswap.exchange/)
- [Repo](https://github.com/iearn-finance/yswap-finance)
- [Yearn Documentation](https://docs.yearn.finance/)
- [Repo](https://github.com/iearn-finance/docs)
- [Yearn Forum](https://gov.yearn.finance/)

#### List of Yearn Tools Developed by the Community
- Yearn Discord FAQ Bot
- [Repo](https://github.com/dgornjakovic/yfi-faq-bot)
- [Yearn Party](https://yearn.party/)
- [Repo](https://github.com/x48-crypto/yearn-party)
- [Yearn Tools (Based off Yearn API)](https://yearn.tools/)
- [Repo](https://github.com/yearn-integrations/api)

#### Community Websites
- [yCosystem (Yearn Community Aggregator)](https://ycosystem.info/) - Repository Of Yearn Links
- [Vaults Finance](https://vaults.finance/) - One click deposit into vaults
- [LearnYearn](https://learnyearn.finance/) Additional explainers and content
- [Yearn Stats](https://stats.finance) - Vault Statistics
- [YFI Address Stats](https://www.yfistats.com/) - TVL and vault pricing information built by @Bob_The_Buidler
- [Yieldfarming](https://yieldfarming.info/)
- [Repo](https://github.com/yieldfarming/yieldfarming)
- [Feel-the-yearn](https://feel-the-yearn.app) - Table of current active strategies
- [yVault ROI Calculator](https://yvault-roi.netlify.app/)
- [Yearn Snapshot](https://yearn.snapshot.page/)
- [Yearn Newsletter](https://yearn.substack.com/) - Weekly YFI newsletter run by [@yfi_nomad](https://twitter.com/yfi_nomad)

#### Social
- Twitter:
- [Official Twitter Account ](https://twitter.com/iearnfinance)
- [Andre Cronje](https://twitter.com/AndreCronjeTech)
- [Klim (CEO of YFI)](https://twitter.com/milkyklim)
- [Blue Kirby](https://twitter.com/bluekirbyfi)
- [Medium](https://medium.com/iearn)
- [Discord](https://discord.com/invite/6PNv2nF)
- [Telegram](https://t.me/yearnfinance)
- [Reddit](https://www.reddit.com/r/yearn_finance/)
- [Github](https://github.com/iearn-finance)