New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. Weโll occasionally send you account related emails.
Already on GitHub? Sign in to your account
๐ ๐ ๐ ๐ข Translate docs to Emoji ๐ฅณ ๐ ๐ฅ ๐คฏ ๐คฏ #5385
Conversation
Codecov ReportPatch and project coverage have no change.
Additional details and impacted files@@ Coverage Diff @@
## master #5385 +/- ##
=========================================
Coverage 100.00% 100.00%
=========================================
Files 540 540
Lines 13969 13951 -18
=========================================
- Hits 13969 13951 -18 see 10 files with indirect coverage changes Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here. โ View full report in Codecov by Sentry. |
๐ Docs preview for commit 5590e38 at: https://6320bdb2dc53d17efc1ba804--fastapi.netlify.app |
docs/emj/docs/features.md
Outdated
* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> ๐ API, โ ๐๐ <abbr title="๐ญ HTTP-๐ฉโ๐ฌ โ : POST, GET, PUT, DELETE">๐ </abbr> <abbr title="๐ญ: ๐, ๐ฃ, '๐ต', โ๏ธ.">๐</abbr>, ๐ข, โ ๐ช, ๐โโ, โ๏ธ. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think "Security" in native emoji is more like "๐ฎ" than your translated "๐โโ". However, the other parts are perfect, I like it
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I find amusing the seriousness of this review. ๐
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It looks๐ like the markup๐ is a bit๐ค broken๐, making it hard๐
to read๐ such great๐ documentation๐.
https://6320bdb2dc53d17efc1ba804--fastapi.netlify.app/emj/
๐ Docs preview for commit 3b37ad3 at: https://6321d213a4b3527ed976768f--fastapi.netlify.app |
@FeeeeK ๐ฅ๐ฅ๐ฅ Fixed ๐ฅ๐ฅ๐ฅ |
Hey there! Is this coming from a joke or something somewhere else? ๐ I imagine that given all the approvals and interactions, but I didn't see the original joke... ๐คท |
Great๐ซ, I think this is a very nice๐ change, making the documentation๐ much friendlier๐. It's a pity that the previousโฎ๏ธ version of the |
Really ๐๐๐ cool ๐๐๐ idea ๐๐ง ๐ซฆ bro ๐ฅต๐๐ฅต!!! |
@tiangolo You see right through us. Forgive us this joke. We're just really sad about the decision to remove the emojis in #3273. They made the documentation unusual and stand out from the documentation of other frameworks. That's why we wanted to bring back that distinctive feature, so we'd be very happy if you could merge this pull request.โค๏ธ |
I think I could do a full translation of all the pages as well as fix a few formatting issues if you would ever consider adding an emoji version of the documentation, just for fun ๐ |
Cool! ๐ฅณ I'm going to finish up translating the remaining pages and prepare this for merging as promised. ๐ |
๐ Docs preview for commit d51f60e at: https://64090307112b5b1b116dc96e--fastapi.netlify.app |
LGTM |
@LeeeeT, I tried to send a review, but for some reason github just gives an error, I have already contacted support, I hope they will help, but for now please wait a bit. |
Well, @FeeeeK, you can submit a pull request with your proposed changes to my fork ๐ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM ๐
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
๐ Docs preview for commit 24527b5 at: https://642663a0b548622487cc93a0--fastapi.netlify.app |
๐ Docs preview for commit d51f60e at: https://6426a87c996bf600a71bb68f--fastapi.netlify.app |
๐ Docs preview for commit 924c274 at: https://6426a9b35d5fc100b1db0463--fastapi.netlify.app |
@FeeeeK It's probably for the best... ๐ |
๐ Docs preview for commit 7b50132 at: https://6427f6b2a6d5896aca012137--fastapi.netlify.app |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm actually impressed. You did an amazing job here. The consistency of the translation from the original is great. ๐ค๐
I moved the content from emj
toem
, that simplifies the URLs and makes using the internal scripts simpler (to run the docs live locally, etc).
em
is not assigned to any other language so that's fine. https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes#Table_of_all_possible_two_letter_codes
I imagine you automatized parts of it, I would love to know how you did it!
I'm also cracking up. ๐
Thank you for your contribution! ๐๐ฐ
@tiangolo For all this, regexes were used to separate the text from code blocks, and then the translation through Yandex translator (link), and after all this, I fixed some inaccuracies and broken emojis. I think this can also be automated and converted to GitHub action, but we need to make it a little more stable. |
Yea, it required some reverse engineering and use of private API in order to automate translating with Yandex. ๐
And my script for extracting readable and translatable text from Anyway, I want to thank all the participants of this pull request. โค๏ธ You guys made the prank even funnier. ๐คช๐ฅฐ |
I just really love ๐ ๐คฉ the idea of adding some emojis ๐๐๐ here and there across the ๐ docs ๐ (like in here for example). So I decided to write โ the entire documentation out of emojis ๐ฅ๐๐. All these words ๐คฎ๐คข and... fancy-looking letters.. ๐๐๐ ugh... That's so boring ๐ฅฑ. I believe reading documentation made of emojis will definitely (don't argue ๐๐คช) be much funnier ๐ and easier ๐ป for beginners. Just take a look at a new awesome ๐ฅ async page ๐ฅ. So here it is, don't thank me. ๐ฅ๐ฏ๐ซโญ