aspect icon indicating copy to clipboard operation
aspect copied to clipboard

Document kaus 2010 block benchmark with sphinx

Open marcel112358 opened this issue 2 years ago • 5 comments

We (@cedrict and I) document the kaus 2010 block benchmark which already has a merged prm file (created by @naliboff). This time with sphinx and we incorporated the feedback from pull request #4608.

Before your first pull request:

  • [x] I have read the guidelines in our CONTRIBUTING.md document.

For all pull requests:

  • [x] I have followed the instructions for indenting my code.

marcel112358 avatar May 23 '22 12:05 marcel112358

There's nothing wrong with opening a new pull request, but out of curiosity, why didn't you just update the one in #4608? This way whoever reads through the history of a PR gets to see the whole history.

bangerth avatar May 23 '22 13:05 bangerth

In the feedback of the other PR I was instructed to open a new one but yes next time I can also update it in the same PR

marcel112358 avatar May 23 '22 14:05 marcel112358

On 5/23/22 08:13, Marcel Saaro wrote:

In the feedback of the other PR I was instructed to open a new one but yes next time I can also update it in the same PR

Ah, I missed that. Sorry for the noise then!

bangerth avatar May 23 '22 14:05 bangerth

@marcel112358 Thanks for reopening this! Before this will be rendered in sphinx, you will need to add your new kaus_2010_extension.md file to the index at the bottom of https://github.com/geodynamics/aspect/blob/main/doc/sphinx/user/benchmarks/index.md. Only once you do that, we will be able to see how it looks like in the html manual (you can see if it appear correctly yourself by clicking on the Details link next to the docs/readthedocs.org:aspect-documentation tester).

@naliboff Do you plan to review this since you already looked at the original version?

jdannberg avatar May 23 '22 16:05 jdannberg

@jdannberg thank you for the feedback regarding the index file. I added it and I can see the page in the test documentation now.

marcel112358 avatar May 24 '22 10:05 marcel112358