<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Jul 17, 2019 at 8:43 AM Dashamir Hoxha <<a href="mailto:dashohoxha@gmail.com">dashohoxha@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div dir="ltr"><br></div><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Jul 17, 2019 at 6:00 AM Ralf Gommers <<a href="mailto:ralf.gommers@gmail.com" target="_blank">ralf.gommers@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>Hi all,</div><div><br></div><div>I just opened <a href="https://github.com/numpy/numpy/pull/14032" target="_blank">https://github.com/numpy/numpy/pull/14032</a>, which contains a NEP for a redesign of the NumPy website (just the top-level site, not the docs). The part that most warrants discussion is probably the translation part. Additions to the NEP from anyone who has useful experiences with managing translations like that would be quite welcome.</div><div><br></div><div>There's a couple of motivations for writing this as a NEP:</div><div>1. Ensure that we're all on the same page before doing quite a bit of work</div><div>2. Empowering people who have offered help with the website to go ahead and make changes. We got a few offers of help from people who are new to the project, which is awesome. I want to make sure they feel comfortable making some decisions.</div><div>3. Pushing forward with the website redesign now prepares the ground for GSoD, where we have tech writers and people with marketing skills that I hope will generate much better content than we have now. Integrating that content is much easier in a well-designed site than into the current Sphinx site.</div><div><br></div><div>I also will start inviting our new volunteers to the NumPy web team, so they have the permissions needed to work on the website repo. <br></div></div></blockquote><div><br></div><div>First of all, choosing a few existing sites as examples to follow is the best thing to do. I like all the three sites selected by Ralf, especially that of Jupiter and Julia. Having such examples makes our job much easier (and also reduces our choices and discussions about possible choices).<br><br>Indeed, if we want to make our site similar to Jupiter, we just fork it (<a href="https://github.com/jupyter/jupyter.github.io" target="_blank">https://github.com/jupyter/jupyter.github.io</a>) and customize its content. If we want to make it similar to Julia, we just fork it: <a href="https://github.com/JuliaLang/www.julialang.org" target="_blank">https://github.com/JuliaLang/www.julialang.org</a> Both of them are in Jekyll and markdown, so this is the only choice (unless we want to make our site similar to that of pandas, which is built with sphinx). We admit that none of us is good as a web designer, so following the example of a nice website is the best way to go.<br></div></div></div></blockquote><div><br></div><div>That could be an idea. Not sure it's much less work (we'd have to change all stying, graphics and text anyway), but it may be. I think<br></div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div><br>I don't understand the need/requirement for translation or i18n. </div></div></div></blockquote><div><br></div><div>The need is simple: for many of our users (the majority I think), English is not the first language. Many people are prevented from learning about NumPy effectively. A few pages in their own language goes a long way to helping them. Also, we're likely missing out on contributions due to this. I've had a number of people tell me that this is a significant barrier.</div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div>None of the sites that we are considering as examples have it, and I have not seen any other sites that have it. Maybe I am missing something. Can someone show an example of a website with translation?<br></div></div></div></blockquote><div><br></div><div>AstroPy is wanting to do this too IIRC. Most widely used commercial software/platforms have this (because they can measure the impact of translations in sales - it matters). Examples: <a href="https://hortonworks.com/">https://hortonworks.com/</a>, <a href="https://aws.amazon.com/">https://aws.amazon.com/</a>.</div><div><br></div><div>An example from an open source project: <a href="https://www.tensorflow.org/guide/extend/bindings">https://www.tensorflow.org/guide/extend/bindings</a> ("language button" at the top, changes to Chinese).</div><div><br></div><div>I'd like to try it and see if we can make it work with low maintenance overhead. If we can't figure out the workflow to make the overhead low enough, then that's a no-go. But I think with today's tools it's possible.</div><div><br></div><div>Cheers,<br></div><div>Ralf</div><div><br></div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div><br>By the way, I know that the docs are not the topic of this NEP, but I think that we should follow the good examples for the documentation of the code as well. For example Jupiter and Julia:</div><div>- <a href="https://jupyter.org/documentation" target="_blank">https://jupyter.org/documentation</a><br>- <a href="https://docs.julialang.org/en/v1/" target="_blank">https://docs.julialang.org/en/v1/</a><br></div><div><br></div><div>Regards,</div><div>Dashamir</div></div></div>
_______________________________________________<br>
NumPy-Discussion mailing list<br>
<a href="mailto:NumPy-Discussion@python.org" target="_blank">NumPy-Discussion@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/numpy-discussion" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/numpy-discussion</a><br>
</blockquote></div></div>