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

[Dave May]

On Fri, 16 Aug 2019 at 20:02, Dave May <dave.mayhem23 at gmail.com> wrote:

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

Sorry - what I wrote was ambiguous. I am proposing "a single link to all
man pages" in the ToC.
 E.g. a link to this
https://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/singleindex.html





> 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-dev/attachments/20190816/64dbd3d2/attachment.html>