<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">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">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">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><br>I don't understand the need/requirement for translation or i18n. 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><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">https://jupyter.org/documentation</a><br>- <a href="https://docs.julialang.org/en/v1/">https://docs.julialang.org/en/v1/</a><br></div><div><br></div><div>Regards,</div><div>Dashamir</div></div></div>