Skip to content

Adding explanation about BG examples in README and quick start#1462

Merged
vissarion merged 1 commit intodevelopfrom
readme_examples_addition
May 7, 2026
Merged

Adding explanation about BG examples in README and quick start#1462
vissarion merged 1 commit intodevelopfrom
readme_examples_addition

Conversation

@vissarion
Copy link
Copy Markdown
Member

This pull request updates documentation to clarify the organization and location of code examples within the Boost.Geometry project as identified in the relevant JOSS review (comment1, comment2).
The changes help users distinguish between standalone tutorial programs and smaller reference snippets, making it easier to find relevant example code.

Documentation improvements:

  • Updated the README.md to specify that the doc directory contains QuickBook documentation sources with embedded examples in doc/src/examples/, and clarified that the example directory contains standalone examples.
  • Added guidance in doc/quickstart.qbk directing users to the example/ directory for longer tutorial-style programs and to doc/src/examples/ for smaller reference-oriented snippets.

@vissarion vissarion requested review from barendgehrels and tinko92 May 5, 2026 10:53
Copy link
Copy Markdown
Collaborator

@tinko92 tinko92 left a comment

Choose a reason for hiding this comment

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

Looks good to me, thanks for managing the submission and related revisions. I noticed the CI failures in earlier CI runs, they seem unrelated to BG to me.

Copy link
Copy Markdown
Collaborator

@barendgehrels barendgehrels left a comment

Choose a reason for hiding this comment

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

👍

@barendgehrels
Copy link
Copy Markdown
Collaborator

Errors:

error: could not resolve project reference '/boost/static_assert'

we should first merge that PR

@vissarion vissarion force-pushed the readme_examples_addition branch from 6672b15 to f8281fb Compare May 6, 2026 19:08
@vissarion vissarion merged commit aed7bc3 into develop May 7, 2026
37 checks passed
@vissarion vissarion deleted the readme_examples_addition branch May 7, 2026 14:37
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.

3 participants