[petsc-dev] Manualpage TOC

[Barry Smith]

  Yes, someone needs to find the time to fix this page, properly organize and order the entries on that page. I did a rush job to convert to .rst for other reasons and have not had time to clean up the page.



> On Oct 20, 2022, at 2:57 PM, Blaise Bourdin <bourdin at mcmaster.ca> wrote:
> 
> Resurrecting this thread:
> I find information really hard to find in https://petsc.org/release/docs/manualpages/ <https://petsc.org/release/docs/manualpages/> now that the hierarchy has been flattened
> In addition, the section headings are inconsistent, and the word “Manual pages” do not provide any information but make rapidly scanning the page more difficult.
> What would need to be done to harmonize the section heading, so that one can quickly locate a section?
> I’d suggest following the template "SNES - nonlinear solvers”, so that one can easily parse by Petsc object type of functionality
> 
> 
> Regards,
> Blaise
>  
>> On Oct 10, 2022, at 11:56 AM, Barry Smith <bsmith at petsc.dev <mailto:bsmith at petsc.dev>> wrote:
>> 
>> 
>>  Oh yes, thanks. Maybe the material at the bottom could be reordered and cleaned up to look like the top used to look. I didn't realize I had destroyed all the structure, I thought I was just removing duplicate lists.
>> 
>>  Barry
>> 
>> 
>>> On Oct 10, 2022, at 11:26 AM, Satish Balay <balay at mcs.anl.gov <mailto:balay at mcs.anl.gov>> wrote:
>>> 
>>> https://gitlab.com/petsc/petsc/-/merge_requests/5724/diffs <https://gitlab.com/petsc/petsc/-/merge_requests/5724/diffs>
>>> 
>>>>>> 
>>> 
>>> * [API Changes in each release](../changes/index.rst)
>>> * [MPI](http://www.mpich.org/static/docs/latest/)
>>> * [Vector Operations (Vec)](Vec/index.md)
>>> <<<<
>>> 
>>> etc was removed. I assumed it wasn't easy to migrate that to  rst format.
>>> 
>>> prev: https://petsc.gitlab.io/-/petsc/-/jobs/3147219016/artifacts/public/html/docs/manualpages/index.html
>>> current: https://petsc.org/release/docs/manualpages/
>>> 
>>> Satish
>>> 
>>> 
>>> On Mon, 10 Oct 2022, Barry Smith wrote:
>>> 
>>>> 
>>>> What is worse about it? What did it look like before? How would you like it to look? 
>>>> 
>>>>  The left hand side on this page is broken and I do not know how to fix it. But the middle panel can be changed to whatever is better
>>>> 
>>>> 
>>>> 
>>>>> On Oct 10, 2022, at 8:47 AM, Matthew Knepley <knepley at gmail.com> wrote:
>>>>> 
>>>>> The new push got rid of the top level organization on this page
>>>>> 
>>>>> https://petsc.org/main/docs/manualpages/ <https://petsc.org/main/docs/manualpages/>
>>>>> 
>>>>> To me, this looks much worse. Is there any way to restore it
>>>>> without reversing the speed gains?
>>>>> 
>>>>>  Matt
>>>>> 
>>>>> -- 
>>>>> What most experimenters take for granted before they begin their experiments is infinitely more interesting than any results to which their experiments lead.
>>>>> -- Norbert Wiener
>>>>> 
>>>>> https://www.cse.buffalo.edu/~knepley/ <http://www.cse.buffalo.edu/~knepley/>
>>>> 
>>>> 
>>> 
>> 
> 
> — 
> Canada Research Chair in Mathematical and Computational Aspects of Solid Mechanics (Tier 1)
> Professor, Department of Mathematics & Statistics
> Hamilton Hall room 409A, McMaster University
> 1280 Main Street West, Hamilton, Ontario L8S 4K1, Canada 
> https://www.math.mcmaster.ca/bourdin <https://www.math.mcmaster.ca/bourdin> | +1 (905) 525 9140 ext. 27243
> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/petsc-dev/attachments/20221023/4d18f104/attachment.html>