Skip to content
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

I would like to translate Docs for this project in Hindi Language #474

Closed
w3Abhishek opened this issue Oct 4, 2020 · 18 comments
Closed
Labels
question Further information is requested

Comments

@w3Abhishek
Copy link

Hi Ciphey,

I am Abhishek Verma from India, and my native language is Hindi. I would like to translate your docs in Hindi so, the guys here in India can read and understand your DOCS.

Please let me know, how I can contribute.

@issue-label-bot issue-label-bot bot added the question Further information is requested label Oct 4, 2020
@issue-label-bot
Copy link

Issue-Label Bot is automatically applying the label question to this issue, with a confidence of 0.72. Please mark this comment with 👍 or 👎 to give our bot feedback!

Links: app homepage, dashboard and code for this bot.

@bee-san
Copy link
Member

bee-san commented Oct 5, 2020

Go ahead! :D Translate the README, the wiki cannot be translated :(

@w3Abhishek
Copy link
Author

Go ahead! :D Translate the README, the wiki cannot be translated :(

thanks for allowing me to do so. I will submit my PR very soon

@lordnodd
Copy link

lordnodd commented Oct 5, 2020

Hey hindi? Indians speak english fine, we don't need a hindi docs, try doing actual work next time and don't slack off. @bee-san I think its not needed we adopted UK english, most of our law proceedings also takes place in english.

@w3Abhishek
Copy link
Author

Okay, then I won't. Let's see is there anything else I can improve in the code itself.
Thanks.

@Albertosaurusrex
Copy link

Hey hindi? Indians speak english fine, we don't need a hindi docs, try doing actual work next time and don't slack off. @bee-san I think its not needed we adopted UK english, most of our law proceedings also takes place in english.

I think when the "founder" of the project say that @w3Abhishek can go ahead and translate it, it's that. There's absolutely no harm in translating it?

If @w3Abhishek wants to translate it, let them! It's to absolutely no cost to anyone but them, but if they want to take the time, they can do it?

@w3Abhishek
Copy link
Author

Thanks @Albertosaurusrex
I am gonna translate and do the job. :)

@bee-san
Copy link
Member

bee-san commented Oct 5, 2020

Hey hindi? Indians speak english fine, we don't need a hindi docs, try doing actual work next time and don't slack off. @bee-san I think its not needed we adopted UK english, most of our law proceedings also takes place in english.

Here's the deal. I don't care. Translate it to Latin for all I care. Of course, we like more contributions to crackers / decoders -- but we don't care.

It's a win/win as far as I can see.

They get hacktoberfest merch

We get more contributors, which makes the project look more impressive -- especially in job interviews.

Go ahead and translate it. And if someone else is reading this right now that knows, I don't know, Latin? Hawaiian? Go ahead too.

If all you can contribute is a translation go ahead :P

@Cyclic3
Copy link
Member

Cyclic3 commented Oct 5, 2020

Hey hindi? Indians speak english fine, we don't need a hindi docs, try doing actual work next time and don't slack off. @bee-san I think its not needed we adopted UK english, most of our law proceedings also takes place in english.

I think you are missing the reason we accept translations. Because of the English-speaking origins of the Internet, a majority of technical discussion and implementation happens in English (pretty much all programming languages are english-based). As a result, this distribution also comes across into Ciphey, and with free online translation services, the rest can still divine some meaning from english text.

HOWEVER, this doesn't mean that this is comfortable or easy for them! More technical details and poor phrasing on our part can make it difficult to understand even for native speakers. The most common reaction people have to this is to silently give up and move on, which means we have a smaller community working on our code, which means less gets done.

Imagine, for a second, that the library's source code was written in an obscure derivative of python, and imagine that the maintainers all wrote and read this fluently. You would be able to understand the basic control flow, and might even be able to contribute after enough study, but it would be a lot of work and an unenjoyable chore. In fact, this very reason is why we have decided not to write the whole thing in C++, despite the significant performance benefits of doing so.

And all of this is ignoring the largest group of people who read our docs: those who are trying to use it themselves without asking us. Ciphey is primarily used for fun (by people trying to do CTFs, crack codes they find online, etc), and any resistance they encounter will most likely cause them to drop it and move on to something else, decreasing the chance they start to engage and submit an eye-opening bug report, a revolutionary feature request, or just tidy up our messy code.

TL;DR: I appreciate that pretty much everyone who uses Ciphey can speak English, but I reject the idea that they would all prefer to. If we can make Ciphey a bit easier to use for just one person, then the negligible hassle of a single PR is worth it. If it doesn't then we've wasted a bit of time. Oh well.

@mitchm0728
Copy link

mitchm0728 commented Oct 6, 2020 via email

@chuinzer
Copy link
Contributor

chuinzer commented Oct 6, 2020

doing actual work next time and don't slack off. @.bee-san I think it's not needed we adopted UK English, most of our law proceedings also take place in English.

then what's the point of the creators accept different language translations? you should read what @Cyclic3 said above

@w3Abhishek
Copy link
Author

Should I go for it or not. Very confused

@Albertosaurusrex
Copy link

@w3Abhishek Go for it.

@lordnodd
Copy link

lordnodd commented Oct 7, 2020

Hey hindi? Indians speak english fine, we don't need a hindi docs, try doing actual work next time and don't slack off. @bee-san I think its not needed we adopted UK english, most of our law proceedings also takes place in english.

I think you are missing the reason we accept translations. Because of the English-speaking origins of the Internet, a majority of technical discussion and implementation happens in English (pretty much all programming languages are english-based). As a result, this distribution also comes across into Ciphey, and with free online translation services, the rest can still divine some meaning from english text.

HOWEVER, this doesn't mean that this is comfortable or easy for them! More technical details and poor phrasing on our part can make it difficult to understand even for native speakers. The most common reaction people have to this is to silently give up and move on, which means we have a smaller community working on our code, which means less gets done.

Imagine, for a second, that the library's source code was written in an obscure derivative of python, and imagine that the maintainers all wrote and read this fluently. You would be able to understand the basic control flow, and might even be able to contribute after enough study, but it would be a lot of work and an unenjoyable chore. In fact, this very reason is why we have decided not to write the whole thing in C++, despite the significant performance benefits of doing so.

And all of this is ignoring the largest group of people who read our docs: those who are trying to use it themselves without asking us. Ciphey is primarily used for fun (by people trying to do CTFs, crack codes they find online, etc), and any resistance they encounter will most likely cause them to drop it and move on to something else, decreasing the chance they start to engage and submit an eye-opening bug report, a revolutionary feature request, or just tidy up our messy code.

TL;DR: I appreciate that pretty much everyone who uses Ciphey can speak English, but I reject the idea that they would all prefer to. If we can make Ciphey a bit easier to use for just one person, then the negligible hassle of a single PR is worth it. If it doesn't then we've wasted a bit of time. Oh well.

cool, I get your point.

@harens
Copy link
Contributor

harens commented Feb 9, 2021

Here's the deal. I don't care. Translate it to Latin for all I care. Of course, we like more contributions to crackers / decoders -- but we don't care.

We get more contributors, which makes the project look more impressive -- especially in job interviews.

I know this issue was opened a while ago (and this is slightly off topic), but I don't know how I feel about this viewpoint.

I spent a lot of time making Ciphey installable via MacPorts #583 and making it easier for other package maintainers to add it to their package manager by writing up different pitfalls and solutions Ciphey/CipheyCore#17.

I'd like to think that these contributions, as well as the contributions of others that put their time and effort into helping, have more value than simply bumping the contributor number for job interviews.

Of course, it goes without saying that I really appreciate all the maintainers' time and effort that goes into maintaining this project. Thank you for all of your work ❤️. But I'd hope that the work of other contributors is also held with value, rather than simply saying that you don't care.

@bee-san
Copy link
Member

bee-san commented Feb 10, 2021

Here's the deal. I don't care. Translate it to Latin for all I care. Of course, we like more contributions to crackers / decoders -- but we don't care.

We get more contributors, which makes the project look more impressive -- especially in job interviews.

I know this issue was opened a while ago (and this is slightly off topic), but I don't know how I feel about this viewpoint.

I spent a lot of time making Ciphey installable via MacPorts #583 and making it easier for other package maintainers to add it to their package manager by writing up different pitfalls and solutions Ciphey/CipheyCore#17.

I'd like to think that these contributions, as well as the contributions of others that put their time and effort into helping, have more value than simply bumping the contributor number for job interviews.

Of course, it goes without saying that I really appreciate all the maintainers' time and effort that goes into maintaining this project. Thank you for all of your work ❤️. But I'd hope that the work of other contributors is also held with value, rather than simply saying that you don't care.

Hey! You're right! Sorry, I have autism so sometimes the words come out of me wrong. I meant it like "all contributions are actually great. I don't care if you do a small spelling fix, or a very large feature request. Both are equally amazing and I am so thankful that someone has taken time out of their busy day to do something for this project".

Of course, we appreciate very large contributions too -- but all contributions matter and we love them all <3 :))))

Contributions from people that know nothing about how Ciphey works is great, as it means our documentation has worked!

PS: @harens the Ciphey core team are working on our hashing stuff, if you wanted to make any Macports for that (it's 100% Python, promise!) please do. It would mean a lot to us, and would probably make it easier in the future as Search-that-hash is going to be the hashing module used in Ciphey :))

https://github.com/HashPals/Name-That-Hash
https://github.com/HashPals/Search-That-Hash

We use Discord to communicate if you wanted :)

https://discord.gg/zYTM3rZM4T

@harens
Copy link
Contributor

harens commented Feb 11, 2021

Thanks for clarifying @bee-san. I'm sorry I misunderstood what you meant, and I'm glad that all contributions are appreciated.

I really did mean it though when I say thank you to you and the other maintainers for putting your time and effort into this project. Your dedication into making a well-documented, super fast and easy-to-use tool for everyone to use is greatly appreciated. Thank you!

PS: @harens the Ciphey core team are working on our hashing stuff, if you wanted to make any Macports for that (it's 100% Python, promise!) please do. It would mean a lot to us, and would probably make it easier in the future as Search-that-hash is going to be the hashing module used in Ciphey :))

I'd be honoured :) It looks relatively straightforward (much more than CipheyCore!) so I'll definitely have a go at that.

@SkeletalDemise
Copy link
Contributor

I'm closing this issue as the original question was answered. If you make a translation, submit it as a PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
question Further information is requested
Projects
None yet
Development

No branches or pull requests

9 participants