Conversation
Hrovatin
requested review from
AVHopp,
AdrianSosic and
Scienfitz
as code owners
This comment was marked as outdated.
This comment was marked as outdated.
|
@Hrovatin please have a compiled version of this on your fork and link it here (ideally in the PR description) since this makes it way easier to review. If there is trouble with deploying things on your fork just ping me and I can help with that :) |
|
Also, can you check where you branched off for this PR? Just switched the branch to view the README on github and this seems to be quite outdated |
Hrovatin
force-pushed
the
docs/easy_access
branch
from
aa1cbcb to
e963d6b
Compare
AdrianSosic
left a comment
AdrianSosic
left a comment
There was a problem hiding this comment.
Hi @Hrovatin, thanks for taking the lead here. I'm welcoming improvements to the README 👍🏼 But we have to make sure that this is not at the cost of:
- introducing inconsistencies
- a lack of precision, i.e. softening the language in such a way that statements become inexact
To show you what I mean, I've added the hashtags #consistency and #rigor to many of my comments. This is only a first round anyway, more comments to come, but I'll now first go over the other existing open threads 🙃
There was a problem hiding this comment.
Pull request overview
This PR improves documentation accessibility by correcting a spelling error and adding new visual assets. The main changes include creating Draw.io source files for documentation diagrams and removing an unnecessary trailing newline.
- Corrected "bayesian" to "Bayesian" in userguide
- Added Draw.io diagram source files for quick start and API overview
- Added Python script for generating 3D landscape visualization
- Removed trailing newline in FAQ file
- Updated README with expanded use cases and clearer optimization workflow explanation
Reviewed changes
Copilot reviewed 6 out of 13 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/userguide/userguide.md | Fixed capitalization of "Bayesian" |
| docs/graphics/landscape.py | Added script to generate 3D optimization landscape plot |
| docs/faq.md | Removed trailing blank line |
| docs/_static/quick_start.drawio | Added Draw.io source file for quick start diagram |
| docs/_static/api_overview.drawio | Added Draw.io source file for API overview diagram |
| README.md | Enhanced README with detailed use cases, workflow diagram, and clearer explanations |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 6 out of 15 changed files in this pull request and generated 2 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Hrovatin
force-pushed
the
docs/easy_access
branch
from
57bad31 to
9efc271
Compare
|
This PR is now rebased upon the PR for images. Diagramas will be from now on updated only on the image PR #726 |
This mini PR contains images required to build documentation from #676
This PR tackles some points from #598, focused on #598 (comment) as agreed on the team meeting
Link to the built documentation
I still have issues with displaying images, will investigate this.