[petsc-users] [petsc-dev] Working Group Beginners: Feedback On Layout

[Dave May]

I think it would useful to have links to all the man pages in the table of
contents.

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.

Overall I like it. Nice work.

Cheers,
Dave

On Fri, 16 Aug 2019 at 16:22, Faibussowitsch, Jacob via petsc-dev <
petsc-dev at mcs.anl.gov> wrote:

> Hello All PETSC Developers/Users!
>
> 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 *layout* and *structure*. The visual
> presentation of the web page and content is still all a WIP, and is not
> necessarily representative of the finished product.
>
> That being said, in order to keep the project moving forward we will *soft-cap
> feedback collection by the end of next Friday (August 23)* 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
> jfaibussowitsch at anl.gov with your comments! Be sure to include specific
> details and examples of what you like and don’t like with your mail.
>
> Here is the template:
> http://patricksanan.com/temp/_build/html/introductory_tutorial_ksp.html
>
> Sincerely,
>
> Jacob Faibussowitsch
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/petsc-users/attachments/20190816/75c26d7f/attachment.html>