<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<blockquote type="cite" class="">
<div dir="auto" class="">I also think it would be useful to have links to the man pages for specific key functions which are fundamental to the objectives of the tutorial. These could appear at the end of the tutorial under a new section heading (eg "Further
reading"). It would be good to keep the list of man pages displayed to a minimum to avoid info overload and obscuring the primary objectives of the tut.</div>
</blockquote>
<div class=""><br class="">
</div>
This is a key goal of the tutorials, in that a new user should not be overloaded with too much info but also have to look in 10 different places in order to get all of the information they need. In the finished product every Petsc function in the text will
have links to the user manual or man pages. Its not currently working in the example shown due to some limitations in the rst framework were using but it will we working in the final product.
<div class=""><br class="">
</div>
<div class="">Another key aspect here is that we are also revamping the user manual and bringing it to a bit more prominence than it was before, the idea being that these tutorials show the basics of how to interact with Petsc and get something going, and then
have links all over the tutorials keywords that would go to the user manual where there is much more detailed information.</div>
<div class="">
<div class=""><br class="">
</div>
<div class="">Thank you for sharing your thoughts, I will relay them back to the rest of the team!</div>
<div class=""><br class="">
<div class="">
<div>Best,</div>
<div><br class="">
</div>
<div>Jacob</div>
</div>
<div><br class="">
<blockquote type="cite" class="">
<div class="">On Aug 16, 2019, at 2:02 PM, Dave May <<a href="mailto:dave.mayhem23@gmail.com" class="">dave.mayhem23@gmail.com</a>> wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<div class="">
<div dir="auto" class="">I think it would useful to have links to all the man pages in the table of contents.</div>
</div>
<div dir="auto" class=""><br class="">
</div>
<div dir="auto" class="">I also think it would be useful to have links to the man pages for specific key functions which are fundamental to the objectives of the tutorial. These could appear at the end of the tutorial under a new section heading (eg "Further
reading"). It would be good to keep the list of man pages displayed to a minimum to avoid info overload and obscuring the primary objectives of the tut.</div>
<div dir="auto" class=""><br class="">
</div>
<div dir="auto" class="">Overall I like it. Nice work.</div>
<div dir="auto" class=""><br class="">
</div>
<div dir="auto" class="">Cheers,</div>
<div dir="auto" class="">Dave</div>
<div class=""><br class="">
<div class="gmail_quote">
<div dir="ltr" class="">On Fri, 16 Aug 2019 at 16:22, Faibussowitsch, Jacob via petsc-dev <<a href="mailto:petsc-dev@mcs.anl.gov" class="">petsc-dev@mcs.anl.gov</a>> wrote:<br class="">
</div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div style="word-wrap:break-word;line-break:after-white-space" class="">Hello All PETSC Developers/Users!
<div class=""><br class="">
</div>
<div class="">As many of you may or may not know, PETSc recently held an all-hands strategic meeting to chart the medium term course for the group. As part of this meeting a working group was formed to focus on beginner tutorial guides aimed at bringing new
users up to speed on how to program basic to intermediate PETSc scripts. We have just completed a first draft of our template for these guides and would like to ask you all for your feedback! Any and all feedback would be greatly appreciated, however please
limit your feedback to the general <u class="">layout</u> and <u class="">structure</u>. The visual presentation of the web page and content is still all a WIP, and is not necessarily representative of the finished product.</div>
<div class=""><br class="">
</div>
<div class="">That being said, in order to keep the project moving forward we will
<b class=""><u class="">soft-cap feedback collection by the end of next Friday (August 23)</u></b> so that we can get started on writing the tutorials and integrating them with the rest of the revamped user-guides. Please email me directly at
<a href="mailto:jfaibussowitsch@anl.gov" target="_blank" class="">jfaibussowitsch@anl.gov</a> with your comments! Be sure to include specific details and examples of what you like and don’t like with your mail.</div>
<div class=""><br class="">
</div>
<div class="">Here is the template:</div>
<div class=""><a href="http://patricksanan.com/temp/_build/html/introductory_tutorial_ksp.html" target="_blank" class="">http://patricksanan.com/temp/_build/html/introductory_tutorial_ksp.html</a></div>
<div class=""><br class="">
</div>
<div class="">
<div class="">
<div class="">Sincerely,</div>
<div class=""><br class="">
</div>
<div class="">Jacob Faibussowitsch</div>
</div>
<br class="">
</div>
</div>
</blockquote>
</div>
</div>
</div>
</blockquote>
</div>
<br class="">
</div>
</div>
</body>
</html>