<html><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><br class=""><div><br class=""><blockquote type="cite" class=""><div class="">Am 23.04.2021 um 04:45 schrieb Barry Smith <<a href="mailto:bsmith@petsc.dev" class="">bsmith@petsc.dev</a>>:</div><br class="Apple-interchange-newline"><div class=""><meta http-equiv="Content-Type" content="text/html; charset=us-ascii" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div class=""><br class=""></div><div class=""> 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. </div><div class=""><br class=""></div><div class=""> 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. </div></div></div></blockquote></div><div><br class=""><blockquote type="cite" class=""><div class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div class=""> For example I am looking at <a href="https://petsc.gitlab.io/-/petsc/-/jobs/1204309863/artifacts/public/overview/features.html" class="">https://petsc.gitlab.io/-/petsc/-/jobs/1204309863/artifacts/public/overview/features.html</a> and I immediately want to ask </div><div class=""><br class=""></div><div class=""> Where is the TS solver table in the list of solver tables?</div></div></div></blockquote><blockquote type="cite" class=""><div class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div class=""><br class=""></div><div class=""> Barry</div><div class=""><br class=""></div><div class=""> 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?</div><div class=""> </div></div></div></blockquote></div><br class=""><div class="">I think the intended way to do this with our Sphinx template would be to add custom HTML templates, which can then be added to the sidebar.</div><div class=""><a href="https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.html#add-your-own-html-templates-to-theme-sections" class="">https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.html#add-your-own-html-templates-to-theme-sections</a></div><div class=""><br class=""></div><div class=""> I'm worried that this involves too much scripting and customization, though. For example here's the way the "edit this page" link is done:</div><div class=""><a href="https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_theme/_templates/edit-this-page.html" class="">https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_theme/_templates/edit-this-page.html</a></div><div class=""><br class=""></div><div class="">Doesn't seem too bad but it relies on a pretty big chunk of Python as well:</div><div class=""><a href="https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_theme/__init__.py#L438" class="">https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_theme/__init__.py#L438</a></div><div class=""><br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">I'll open an issue on this, though, since it's entirely possible that someone else (or me, later) will think of a simple way to make this work, as it would indeed be a great feature.</div></body></html>