# We Need Better Docs -- Who Can Help? **URL:** \ **Category:** Feedback\ **Created:** [27 August 2020 09:49 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785 "2020-08-27T09:49:41Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![tracheopteryx](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/tracheopteryx/32/3979_2.png) [@tracheopteryx](https://gov.yearn.fi/u/tracheopteryx)\ **Post date:** [27 August 2020 09:49 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/1 "2020-08-27T09:49:41Z")
We need better docs. Please weigh in here with your thoughts to help us self-organize and take this on together. We’ve also created a special interest group on the discord as an HQ for on-going work in this domain: [#documentation](https://discord.gg/sftUTp5) **Here are some initial guidance questions:** - what docs do we need? - how should we self-organize around docs management? - what should docs.yearn.finance look and feel like? - what are the best documentation examples in DeFi? (I like [https://docs.aave.com/portal/](https://docs.aave.com/portal/)) **Call to Action — we need your help!** - Wizards who understand each detail of how yearn works - Technical writers - Copywriters - Editors - Motivated folks with project management skills - Web devs - Designers and illustrators (for graphics, diagrams) - Animators, video-makers ([Zapper example](https://youtu.be/jzlo5sl_wA4)) **Join us on [#documentation](https://discord.gg/sftUTp5) and let’s get this done.** 📄 📄 📄 ---
**Author:** ![Danger](https://avatars.discourse-cdn.com/v4/letter/d/bbe5ce/32.png) [@Danger](https://gov.yearn.fi/u/Danger)\ **Post date:** [27 August 2020 10:34 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/2 "2020-08-27T10:34:00Z")
Hey there, This is danger. I’m a professional copywriter/marketer, 7 years and counting. Also have an engineering degree Can definitely help out here, esp. on copy side. My time is pretty limited but I just want to put my name out there. I’ll try to check back in on this thread but feel free to dm me here or on twitter for this. ---
**Author:** ![WrongNebula](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/wrongnebula/32/1646_2.png) [@WrongNebula](https://gov.yearn.fi/u/WrongNebula)\ **Post date:** [27 August 2020 10:48 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/3 "2020-08-27T10:48:53Z")
Apparently Gitbook supports the following languages: English, French, Spanish, Chinese (simplified) and Japanese. And allow for multi-lang documentations. I’d be interested in helping for a French translation. Also, we definitely need Chinese! ---
**Author:** ![Juanma](https://avatars.discourse-cdn.com/v4/letter/j/bc8723/32.png) [@Juanma](https://gov.yearn.fi/u/Juanma)\ **Post date:** [27 August 2020 10:59 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/4 "2020-08-27T10:59:51Z")
I can also help translating them to Spanish. ---
**Author:** ![nakadaole](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/nakadaole/32/648_2.png) [@nakadaole](https://gov.yearn.fi/u/nakadaole)\ **Post date:** [27 August 2020 11:08 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/5 "2020-08-27T11:08:58Z")
I can translate every bit into Chinese. ---
**Author:** ![fish](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/fish/32/803_2.png) [@fish](https://gov.yearn.fi/u/fish)\ **Post date:** [27 August 2020 11:57 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/6 "2020-08-27T11:57:40Z")
Would be happy to translate everything available to portuguese, I’ve been doing it for personal use anyway ---
**Author:** ![tracheopteryx](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/tracheopteryx/32/3979_2.png) [@tracheopteryx](https://gov.yearn.fi/u/tracheopteryx)\ **Post date:** [27 August 2020 12:02 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/7 "2020-08-27T12:02:08Z")
Amazing turn out! Thanks everyone so far, this is going to be great. Realized we also need designers and illustrators to create graphics. And would be great to do animations and videos too. Will update. ---
**Author:** ![WrongNebula](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/wrongnebula/32/1646_2.png) [@WrongNebula](https://gov.yearn.fi/u/WrongNebula)\ **Post date:** [27 August 2020 13:00 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/9 "2020-08-27T13:00:08Z")
Small suggestion, It’s great to have a full blown documentation such as _docs.yearn.finance_ or a knowledge base like _learnyearn.finance_ but it would be also good to have a FAQ on the Yearn website(s) I’m thinking of a one page like the one made for Dharma ([link](https://www.dharma.io/faq)) Of course there would be links from this simpler FAQ to the more detailed documentation if needed. ---
**Author:** ![hrsalazar](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/hrsalazar/32/1066_2.png) [@hrsalazar](https://gov.yearn.fi/u/hrsalazar)\ **Post date:** [27 August 2020 13:03 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/10 "2020-08-27T13:03:21Z")
Count me in for Spanish translation 👆🏻 ---
**Author:** ![tracheopteryx](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/tracheopteryx/32/3979_2.png) [@tracheopteryx](https://gov.yearn.fi/u/tracheopteryx)\ **Post date:** [27 August 2020 13:16 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/11 "2020-08-27T13:16:19Z")
> [@WrongNebula](#): > > it would be also good to have a FAQ on the Yearn website(s) Have you seen [https://docs.yearn.finance/faq](https://docs.yearn.finance/faq)? Or were you thinking of something different? ---
**Author:** ![WrongNebula](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/wrongnebula/32/1646_2.png) [@WrongNebula](https://gov.yearn.fi/u/WrongNebula)\ **Post date:** [27 August 2020 13:24 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/12 "2020-08-27T13:24:25Z")
Yes I saw it. I was thinking of something directly on _yearn.finance_ that doesn’t take you _out_ of the UX/UI of the main website. A page like [https://www.dharma.io/faq](https://www.dharma.io/faq) A bit like how you stay in the same flow when you move from vaults to zap. ---
**Author:** ![tracheopteryx](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/tracheopteryx/32/3979_2.png) [@tracheopteryx](https://gov.yearn.fi/u/tracheopteryx)\ **Post date:** [27 August 2020 13:26 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/13 "2020-08-27T13:26:18Z")
yes, agreed. I think we’re waiting on a site redesign or update for that, but maybe we should find a quicker way to do it. ---
**Author:** ![miguel567](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/miguel567/32/1068_2.png) [@miguel567](https://gov.yearn.fi/u/miguel567)\ **Post date:** [27 August 2020 13:38 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/14 "2020-08-27T13:38:50Z")
What docs do we need? - A set of Economic and Tokenomic concepts that are the base for yTokens, yVaults (pools). - a Definitions of KPIs displayed through the website: APY, ROI, etc. What they mean, and how are they calculated to drive further trust and inform each user about how to calculate their profits and risks. ---
**Author:** ![tracheopteryx](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/tracheopteryx/32/3979_2.png) [@tracheopteryx](https://gov.yearn.fi/u/tracheopteryx)\ **Post date:** [27 August 2020 14:02 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/15 "2020-08-27T14:02:59Z")
I made a dashboard with how-to for this process in hackmd, it’s here: [https://hackmd.io/@yearn/docsHQ/edit](https://hackmd.io/@yearn/docsHQ/edit) **Rule #1** : Have an idea to make something better? Don’t ask, just do it. _Version tracking exists._🤯 ---
**Author:** ![Gwen.Steveson](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/gwen.steveson/32/1039_2.png) [@Gwen.Steveson](https://gov.yearn.fi/u/Gwen.Steveson)\ **Post date:** [28 August 2020 00:15 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/16 "2020-08-28T00:15:11Z")
Well use on daily basis , DeepL : - Free of charge, fast and easy - Need a certain amount of text for good results Finally, DeepL is, as you might expect, not wholly error-free. But It is japan friendly , and more languages will come soon. ---
**Author:** ![learnyearn](https://dub1.discourse-cdn.com/flex013/user_avatar/gov.yearn.fi/learnyearn/32/662_2.png) [@learnyearn](https://gov.yearn.fi/u/learnyearn)\ **Post date:** [28 August 2020 02:18 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/17 "2020-08-28T02:18:11Z")
I’m so happy that @tracheopteryx is leading the way on official YFI docs and will support any way I can! The burden has been lifted. I can now return to doing what I do best… spreading the gospel of YFI. Few understand. ---
**Author:** ![CryptoOGkauai](https://avatars.discourse-cdn.com/v4/letter/c/a88e4f/32.png) [@CryptoOGkauai](https://gov.yearn.fi/u/CryptoOGkauai)\ **Post date:** [28 August 2020 18:19 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/18 "2020-08-28T18:19:42Z")
I would love to help. As part of being a Sr. IT Engineer, I have over 15 years experience writing Standard Operating Procedures, Internal Procedures, and Instructions for commercial and government research labs that are utilized by Engineers and Technicians. I attempt to write my documentation so that it can be generally understood by a layperson with some minimal knowledge of the field. You may have seen me on the YFI subreddit. I’m the most active contributor there and I patiently educate and answer questions from crypto newbies and new YFI investors. Fortunately, I discovered the wonders of BTC at about $50 and I soon started mining with Gen 2 ASICs and GPUs in my home. I went on to organize some of the largest community run Bitcoin mining pools. At its peak, our community’s hashrate was larger than most large countries on the biggest mining pool at the time. I have also run community organized Darkcoin Masternodes running Alpha code, where I was also the SysAdmin of the Masternode servers. I’ve also written guides to help my fellow crypto investors, including this yield farming guide well before the term DeFi became the biggest thing in crypto in 2020: > **[How to earn extra income from your Bitcoin and Altcoins at minimal risk\* —...](https://steemit.com/bitcoin/@allyourcrypto/how-to-earn-extra-income-from-your-bitcoin-and-altcoins-at-minimal-risk)** > > For the unwary, there are a lot of ways to lose money in the world of cryptocurrencies. That's a topic that could fill… by allyourcrypto And how to use CeFi to stack LINK: [[Album] Chainlink CeFi Yield Farming - Part 1 ![](https://europe1.discourse-cdn.com/flex013/uploads/yearn/original/2X/e/ec5bb4c245268fabc6b76cd5c10c43ff6251ddb1.jpeg "Chainlink CeFi Yield Farming - Part 1") ](https://imgur.com/a/XzdvUH0) [[Album] Chainlink CeFi Yield Farming - Part 2 ![](https://europe1.discourse-cdn.com/flex013/uploads/yearn/original/2X/5/563eb4a36edfa38a30022d34c34fb173ed86e5e4.jpeg "Chainlink CeFi Yield Farming - Part 2") ](https://imgur.com/a/gUnddqn) (a deleted post because apparently we’re only supposed to talk about the wonders of delivering untampered oracle data, and Chainlink business deals) My next guide will be released today. It was requested by a couple members in the ETHtrader sub. It’s a write up about the process of earning higher interest on their LINK deposits in the form of aLINK and yaLINK. ---
**Author:** ![CryptoOGkauai](https://avatars.discourse-cdn.com/v4/letter/c/a88e4f/32.png) [@CryptoOGkauai](https://gov.yearn.fi/u/CryptoOGkauai)\ **Post date:** [28 August 2020 18:27 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/19 "2020-08-28T18:27:41Z")
BTW, I absolutely love your work. Thank you! I’ve directed a couple of YFI newbies on Reddit to your repository, as it’s probably the best all-in-one information repository about this project. ---
**Author:** ![CryptoOGkauai](https://avatars.discourse-cdn.com/v4/letter/c/a88e4f/32.png) [@CryptoOGkauai](https://gov.yearn.fi/u/CryptoOGkauai)\ **Post date:** [28 August 2020 18:31 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/20 "2020-08-28T18:31:00Z")
Wow! Well done. I may have to take you up on your offer. Anyone feel free to edit/delete anything I may submit, as no one’s prefect and all that. ---
**Author:** ![girafFe](https://avatars.discourse-cdn.com/v4/letter/g/f1d935/32.png) [@girafFe](https://gov.yearn.fi/u/girafFe)\ **Post date:** [30 August 2020 05:12 UTC](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785/21 "2020-08-30T05:12:26Z")
copywriter with 15+ years experience checking in. not super tech savvy, but understand enough. feel free to hit me up for assistance with anything. [Next page](https://gov.yearn.fi/t/we-need-better-docs-who-can-help/3785.md?page=2)