I just went in and made edits on HackMD to the Introductory page. I fixed some minor grammatical errors, did some formatting, and added what I hope is information that is concise, relevant, correct and informative.
I’m the one that made edits on Sunday night. Feedback or corrections are welcome.
Been a busy weekend. I’ve been doing volunteer Tier 1 Tech Support for a ton of new investors on Reddit’s yEarn Finance sub. Subscriptions to the sub exploded this weekend and I was fielding questions left and right.
I wrote the first and second drafts for our glossary for DeFi and yEarn.
To whoever edited the first draft, I’m loving the edits! I’ve never had an editor before for my online writing and I definitely can see the improvements made to that first draft.
The reason why I bring up the actual format of the documents is because it will make it much easier to update and keep consistent the documentation across languages (re: git diff’s). Enforcing a format will help with this. For example, here is an attempt at purely using shell scripts to combine all YIPs into one SUMMARY file, https://github.com/sambacha/YIPS/blob/mdbook/build/YIPS/SUMMARY.md
you can see that it does not provide useful information as the format for YIPs does not enforce authors to change line titles, etc. This will be important for translation (assuming not using some automated English to > * service )
Hey can someone please confirm if we’re going with the final spelling of the Lending Aggregator as: “Yearn”, “yEarn” or just" Earn"?
And for the vaults it going to be a “Vault” or a “yVault”?
This matters because this will be the introductory page for people reading about the project, and will set the template for how it is referenced in all guides and documents going forward. I’d like to get a definite answer on this so we can consider the final Intro Page text and descriptions as a Version 1.0 (or close to it) and move on to helping to write and finish other things.
I strongly do not recommend using just “Earn” for the title of the Lending Aggregator as that is already taken by Crypto.com, a top 12 coin and business, and could lead to confusion amongst CeFi and DeFi investors.
Trach and I were discussing this among others. I think we should be moving towards calling it the Yearn ecosystem and away from using yEarn altogether. Not sure where it came from as I don’t recall any initial medium posts or documents. I do recall Andre’s posts specifying yVaults and ySwap and things of that nature, for now we can continue referring them as such.
The Introduction page and the documents about a lot of the products are going to get reviewed by some developers, but overall we can keep in mind that current names are subject to change. The “Earn” is derived from how it is presented on the yearn.finance site. I think it would be more appropriate to call it the yPool at curve.finance, which is essentially what it is.
Agree, that it probably shouldn’t be called “Earn”, open to feedback.
Working on this map with @FutureFund, @franklin and others, very rough still and in-progress but would love feedback. Planning to combine this with some other threads of work and write more details in a forum post asap.
A critical piece here is clarifying our product line. This model breaks deposit options down into 3 tiers and is informed by how Andre describes yearn on the Uncommon Core podcasts. Here is that model with a bit of initial copywriting:
yUSDC etc Vaults and yTokens need to rename to differentiate from yMarket tier.
yUSDCv?
Again, this is still rough and early. I’m not loving the Vaults vs yVaults distinction, many other pieces not gelling fully for me either. All feedback and critique is welcome! More soon.
@tracheopteryx, Well done on the FAQ regarding fees! While reading, I noticed some very minor errors that should be edited They’re bolded and italicized below…
"Formerly this was called a “5% fee on subsidized gas” which confused literally everyone except Andre. Technically it is not a performance fee—it’s a fee on the some profit-generating transactions that incur high gas costs and are critical to the vault’s internal functioning.
Each vault hasis multiple levels. Here are two examples that show where this fee is taken when the harvest() function is called."
I would change “vaults” in the flow to something else. Perhaps “Yield”? I think having “yVaults” as a dependent of “Vaults” is too confusing.
For the naming convention, so that it makes sense to newcomers, I think all of the vault tokens should have a prefix– perhaps “yv”? Also, are there any chances we fill out the yPools and the yMarkets? Once tokenized BTC is common enough, I could certainly see a similar yPool with several types of BTC that lend out the best market and also earns trading fees (just like the stablecoin Y pool does on Curve). Thinking of this, it also may be worth denoting these with the prefix “yp”. In this case, it also might make sense for the yCRV/yCURVE to instead be ypUSD– since these are stablecoins, not some curve token– it just happens to be hosted on curve as the trading market.
