Skip to content

Setup sphinx documentation#7

Merged
JaroCamphuijsen merged 12 commits intomainfrom
5-documentation-infra
May 6, 2026
Merged

Setup sphinx documentation#7
JaroCamphuijsen merged 12 commits intomainfrom
5-documentation-infra

Conversation

@JaroCamphuijsen
Copy link
Copy Markdown
Member

@JaroCamphuijsen JaroCamphuijsen commented Mar 17, 2026

fix #5
fix #6

Follow the instructions in README.dev.md to build the documentation locally.

and/or have a look at https://nlesc.github.io/corticalsim3D/

@JaroCamphuijsen JaroCamphuijsen marked this pull request as draft March 17, 2026 15:15
@JaroCamphuijsen JaroCamphuijsen self-assigned this Apr 14, 2026
@JaroCamphuijsen JaroCamphuijsen marked this pull request as ready for review April 21, 2026 15:01
@JaroCamphuijsen
Copy link
Copy Markdown
Member Author

I also added a workflow to build the documentation while I was at it

@JaroCamphuijsen
Copy link
Copy Markdown
Member Author

I had a quick look at using meson to build the documentation, but it would not make things a lot simpler than they already are. At the moment it is only two or three steps to build the docs locally and/or in the github workflow. We can always integrate it if things become more complex or if we think it is better.

Copy link
Copy Markdown
Member

@cantordust cantordust left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome - the documentation builds and looks great!🚀 I just made some suggestions on the text, I'll leave it up to you to decide if you want to accept them.🙂

Comment thread doc/conf.py Outdated
Comment thread doc/introduction.md Outdated
Comment thread doc/introduction.md Outdated
Comment thread doc/introduction.md Outdated
Comment thread doc/introduction.md Outdated
Comment thread README.dev.md Outdated
Comment thread README.dev.md Outdated
Comment thread README.dev.md Outdated
Comment thread README.dev.md Outdated
Comment thread README.dev.md Outdated
JaroCamphuijsen and others added 2 commits May 6, 2026 16:12
Thanks for the review! These were all reasonable suggestions. Most of the text in "introduction.md" actually came from the referenced paper, so the text fixes should be in there. For me this is a placeholder anyway, as I think Eva and/or Bandan should write these parts. For now i just accepted your contributions, which made it more readable.

Co-authored-by: Alexander Hadjiivanov <43831101+cantordust@users.noreply.github.com>
@JaroCamphuijsen JaroCamphuijsen merged commit e9ba3ff into main May 6, 2026
2 checks passed
@JaroCamphuijsen JaroCamphuijsen deleted the 5-documentation-infra branch May 6, 2026 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Setup documentation CI with gh-pages Set up documentation infrastructure

2 participants