<div dir="ltr">Hello Melissa ,<div>Just read your email regarding docs meeting ,</div><div>I have now also tried to use <a href="https://bjnath.github.io/demodocs/new_docs_dev">https://bjnath.github.io/demodocs/new_docs_dev</a> as a way to build docs , they were really useful for me as now i have got the message "build succeeded.</div><br>The HTML pages are in build/html." .<br><div><br></div><div>I believe we can really replace  <a href="https://numpy.org/devdocs/dev/index.html" target="_blank">https://numpy.org/devdocs/dev/index.html</a> with  <a href="https://bjnath.github.io/demodocs/new_docs_dev">https://bjnath.github.io/demodocs/new_docs_dev</a> , the former being incomplete  and sometimes misleading .</div><div>I can now really start on with contributing to NumPy having done my Development setup .</div><div>I would also like to ask what are the fields in NumPy Docs that u would really like me to contribute to ,</div><div>should i be doing as per my proposal or an issue ?</div><div><br></div><div>Looking forward to hearing from you</div><div>Best,</div><div>Mrinal </div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, 3 Jul 2020 at 18:49, Saber Tooth <<a href="mailto:sabertooth2022@gmail.com">sabertooth2022@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">Hi Melissa ,<div>I have been trying to follow <a href="https://numpy.org/devdocs/dev/index.html" target="_blank">https://numpy.org/devdocs/dev/index.html</a> and build docs , i am not able to execute the building albeit following the exact guidelines.</div><div>Is there a slack channel for this as i'd be able to better explain / resolve it there , till then :</div><div><br></div><div>I have tried make html command after adhering to the above link</div><div>Error when i haven't switched it to required git version :</div><div><br></div><div>installed numpy 32f514f546 != current repo git version '3cf4c28906'<br>use "make dist" or "GITVER=32f514f546 make html ..."<br>Makefile:93: recipe for target 'version-check' failed<br>make: *** [version-check] Error 1<br></div><div><br></div><div>Now when i make it work as per my installed numpy version :</div><div><br></div><div>There are quite a lot of warnings and many problems like :</div><div><br></div><div>document isn't included in any toctree<br></div><div>failed to import 'numpy.polynomial.set_default_printstyle': no module named numpy.polynomial.set_default_printstyle<br></div><div>WARNING: autodoc: failed to import module 'typing' from module 'numpy'; the following exception was raised:<br></div><div>No module named 'numpy.typing'<br></div><div><br></div><div>Many modules were missing which gave a warning ,</div><div><br></div><div>Now maybe the errors are coming in just my workspace , but I have tried reinstalling everything , got the latest version of cython too .</div><div><br></div><div>It would be really helpful for me if you are able to give me some advice , or a workaround for the problem </div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, 26 Jun 2020 at 01:39, Melissa Mendonça <<a href="mailto:melissawm@gmail.com" target="_blank">melissawm@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>Hello Mrinal,</div><div><br></div><div>I don't think I have any other specific issues to comment on your proposal. The mentors will analyze all proposals after July 9th.</div><div><br></div><div>If you want to start contributing to the docs, you are welcome. You can check the Contributor Guide (<a href="https://numpy.org/devdocs/dev/index.html" target="_blank">https://numpy.org/devdocs/dev/index.html</a>), How to contribute documentation (<a href="https://numpy.org/devdocs/dev/howto-docs.html" target="_blank">https://numpy.org/devdocs/dev/howto-docs.html</a>) and the current documentation.</div><div><br></div><div>Thanks,</div><div><br></div><div>Melissa<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Jun 25, 2020 at 2:27 PM Saber Tooth <<a href="mailto:sabertooth2022@gmail.com" target="_blank">sabertooth2022@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><div dir="auto">Hello Melissa ,</div><div dir="auto">I have altered and built upon my previous proposal , if you could take a few minutes to read it it would be great . I have tried to explain the sections we had discussed in the meeting on 22 June . </div><div dir="auto"><br></div><div dir="auto">Moreover as per your feedback , I would like to start contributing to the docs and start building the docs in my Linux environment .</div><div dir="auto"><br></div><div dir="auto">Best ,</div><div dir="auto">Mrinal Tyagi </div><div dir="auto"><br></div></div><div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, 24 Jun 2020 at 2:36 PM, Saber Tooth <<a href="mailto:sabertooth2022@gmail.com" target="_blank">sabertooth2022@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">Hello Melissa and all the Mentors  ,<div><br></div><div>In the last meeting of NumPy Docs held on June 22nd , I had Proposed Tutorial and Faqs structure , where it was discussed how we should include them in the new structured Documentation .</div><div>Now after a lot of Googling I have been able to provide a structured solution </div><div>It is very important for us to include the FAQs section , but why ?</div><div>If we see how many views some questions on Stack overflow <a href="https://stackoverflow.com/questions/tagged/numpy?tab=frequent&page=1&pagesize=15" target="_blank">https://stackoverflow.com/questions/tagged/numpy?tab=frequent&page=1&pagesize=15</a>  have got the answer is obvious , the 1st page itself has garnered some 4-5 <b>million </b>views and there are really many questions . It means if we are able to answer some of these questions ,not necessarily the exact questions , it would be really good for the Docs .</div><div><br></div><div>I have tried to break the FAQs page into sections so that everything is not cramped onto one page and we have good docs as per SEO guidelines .</div><div>I have structured based on best practices for the FAQs section : <a href="https://www.shivarweb.com/9665/faq-page-best-practices/" target="_blank">https://www.shivarweb.com/9665/faq-page-best-practices/</a> .</div><div><br></div><div>I have improved further upon my previous proposal , please have a look.</div><div>Eagerly waiting <a class="gmail_plusreply" id="gmail-m_-1195664836649209905gmail-m_7295596784496356949gmail-m_8224304513327826922gmail-m_5202186222117827533gmail-m_-55053076534904495m_2936023806175543523plusReplyChip-0" href="mailto:melissawm@gmail.com" target="_blank">@Melissa Mendonça</a> <a class="gmail_plusreply" id="gmail-m_-1195664836649209905gmail-m_7295596784496356949gmail-m_8224304513327826922gmail-m_5202186222117827533gmail-m_-55053076534904495m_2936023806175543523plusReplyChip-1" href="mailto:ralf.gommers@gmail.com" target="_blank">@Ralf Gommers</a>  for your feedback on the same , I would be obliged if you have some ideas which could be incorporated with the same or built upon these .</div><div><br></div><div><br></div><div><br></div><div>Link to Proposal : <a href="https://docs.google.com/document/d/1q-BYO-GqlBIsMizCzjbANORz6OOaC-6oEzuE1_HqJl4/edit?usp=sharing" target="_blank">https://docs.google.com/document/d/1q-BYO-GqlBIsMizCzjbANORz6OOaC-6oEzuE1_HqJl4/edit?usp=sharing</a> <br></div><div><br></div><div>Link to FAQs Proposed structure : <a href="https://docs.google.com/document/d/1q-BYO-GqlBIsMizCzjbANORz6OOaC-6oEzuE1_HqJl4/edit#bookmark=id.2vkitb6djmq0" target="_blank">https://docs.google.com/document/d/1q-BYO-GqlBIsMizCzjbANORz6OOaC-6oEzuE1_HqJl4/edit#bookmark=id.2vkitb6djmq0</a></div><div><br></div><div>Link to Tutorials Proposed structure : <a href="https://docs.google.com/document/d/1q-BYO-GqlBIsMizCzjbANORz6OOaC-6oEzuE1_HqJl4/edit#bookmark=id.pwfvp3lbd2fx" target="_blank">https://docs.google.com/document/d/1q-BYO-GqlBIsMizCzjbANORz6OOaC-6oEzuE1_HqJl4/edit#bookmark=id.pwfvp3lbd2fx</a><br></div><div><br></div><div>Thanks ,</div><div>Mrinal Tyagi</div></div>
</blockquote></div></div>
</blockquote></div>
</blockquote></div>
</blockquote></div>