Skip to content

Support README.adoc as fallback for library descriptions#2275

Open
gregjkal wants to merge 3 commits intodevelopfrom
gk/README.adoc-support
Open

Support README.adoc as fallback for library descriptions#2275
gregjkal wants to merge 3 commits intodevelopfrom
gk/README.adoc-support

Conversation

@gregjkal
Copy link
Copy Markdown
Collaborator

@gregjkal gregjkal commented Apr 3, 2026

Fixes #2182

Adds README.adoc as a third fallback option in Library.get_description, tried after doc/library-detail.adoc and README.md.

  • Appended README.adoc to the files list in get_description
  • Existing .adoc conversion logic handles it automatically
  • Added parametrized test covering file priority and the no-files-found case

Locally, Boost.URL, version 1.91.0-beta1 now shows a library description from its README.adoc (note there is a pre-existing table stretching display bug):
URL library description from README.adoc

@gregjkal gregjkal marked this pull request as ready for review April 3, 2026 16:02
@gregjkal gregjkal requested a review from jlchilders11 April 6, 2026 14:52
Copy link
Copy Markdown
Collaborator

@jlchilders11 jlchilders11 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, seems like a clean switch over to using the new file.

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.

Library detail page: render README.adoc , v2

2 participants