We need Documentation my Goldfish could understand

1. General Discussion
#3

Haha, watching those folks fumble with their chocolate chips is what inspired me to take on this effort. I see the same issue in Abra and plan to quietly make explainer videos for them and then just leave them in a mods DMs to do with what they please.

They’re both really great products and the DeFi aspect of them makes them even more powerful and open. It’s really a benefit to the general population to learn about these kinds of financial products and how to use them. If the crypto part of it is what brings them in, I’m fine with that, as long as we have some material to teach them with while they’re here.

I bet you have some talents you could bring into the effort. If you think of something you’d like to get involved in, my door is broken so it’s always open. :wink:

1 Like
#4

Well, I am not completely dumb and have a VERY good command of the French language! :slight_smile:
If you are ever in need of translation, my door is broken too! :wink:

3 Likes
#5

And by the way, I completely agree with you, they ARE great products! :wink:

1 Like
#6

Your way with words will Definitely come in handy, who doesn’t love French?

#7

I do not! I am Belgian! Owwwwww, Belgium!!! :rofl:

2 Likes
#8

Could we make a Flemish translation of the docs?

#9

I agree. I don’t consider myself highly intelligent, but also not dumb. For the documentation I would need a dictionary. It’s really hard to grasp (maybe also because I am quite new to crypto world)…

1 Like
#10

I am sure we could, but my command of Dutch (or Flemish) is not as good as French (my mother tongue is French, as you have probably figured by now) :slight_smile:

2 Likes
#11

This is exactly my point. Yeah, you guys are clever, we get it. Can we just have some blurbs on the side with clear concise descriptions and real world examples? It’s accepted already we need to explain on a level with things like cookies, let’s just bring that over to the docs and make my grandma see the picture clearly.

We can do this.

#12

Can you pick out one spot in the docs where you found yourself thinking, okay this is a new word or phrase, and had to figure out what it meant outside the docs? It’s these points we need to focus on.

It’s okay to use new words, but they need to be used in a way that the words surrounding them make it difficult to misunderstand. We can’t just use big words to save space or look smart, all the words need to have utility.

1 Like
#13

I agree, I am a little tight on time; no pun intended, but I think the documentation could be improved.

I say this as someone is new to the project and updated examples especially concerning wrapping and staking would be appreciated.

My discord is Kalam#9400 (I just joined, but I cannot see any of the threads #faqs,#resources – It says I don’t have permisison)

I would be willing to help on this subject…

1 Like
#14

I have little time to spare but would like to contribute.

1 Like
#15

The better and simpler the documentation is the more we as whole can get value out from it, so I’m absolutely in favour of this proposal. Also we must find ways to force people reading it since very few do it given the questions that are common on Discord.

1 Like
#16

I am pretty sure many people read but don’t really understand it fully. I has to watch several youtube videos that did a better job of explaining staking, minting, apy and so on…

The easier the better!

#17

There’s no such thing as too little help to offer. I’ll reach out on discord today and keep the conversation open. We’re just getting things worked out on how to go about this, so we’ll take our time to do it right.

#18

I can’t seem to find you in the discord. Check to make sure you’ve reacted to the rules and followed the verify-here process. I think a bot DM’s you that you have to communicate with to verify you’re a human before you’re allowed access to the discord.

#19

Ad am FYI, docs are ready being updated by the team. Now, I woukd expect there will be room for improvement, but it seems counter productive to work on the ones that are there right now.

2 Likes
#20

If at one point there is need for German doc, I might be able to help out (English teacher from Germany) :stuck_out_tongue:

2 Likes
#21

I very much agree with your point, it can end up being an exercise in futility to get together and brainstorm ways to make everything better, the team could have everything handled already. It’s not my intention to require replacements of anything they have with content we create. What we’re hoping to do is come together as a community to figure out exactly what the community thinks needs changed, then create the content with those changes, and deliver that content to the team to do with as they please. If they’d like to toss it in the rubbish bin, that’s perfectly fine. We feel their job might be made easier and the community’s voices clearer, if we can help create some of this content alongside them, to use at their disposal.

#22

This topic was automatically closed 7 days after the last reply. New replies are no longer allowed.