[petsc-dev] commenting on/asking questions on documentation pages

Barry Smith bsmith at petsc.dev
Thu Apr 22 21:45:03 CDT 2021


   I can edit documentation pages directly from the page now, this is totally awesome but I see no button to comment or ask questions on a page. 

   I think every page should, by the edit button, have a "Comment, ask questions" button that anyone can click on to make a comment or ask a question about the page. It would be super fantastic if they could refer to particular people in their comments but perhaps that is too difficult. 

    For example I am looking at https://petsc.gitlab.io/-/petsc/-/jobs/1204309863/artifacts/public/overview/features.html <https://petsc.gitlab.io/-/petsc/-/jobs/1204309863/artifacts/public/overview/features.html> and I immediately want to ask 

    Where is the TS solver table in the list of solver tables?

    Barry

    Note the pre-historic PETSc html manual pages which everyone despises have a button in the upper right hand corner to report problems/ask questions so what I am asking for is not unprecedented. Our old code uses email which is not ideal but not ideal is better than not. Surely modern systems like Sphinx have this support built in?
    
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/petsc-dev/attachments/20210422/1fff1592/attachment.html>


More information about the petsc-dev mailing list