Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add more non-platform extensions to dev services guide + make guide guide-ier #39913

Merged
merged 2 commits into from Apr 7, 2024

Conversation

holly-cummins
Copy link
Contributor

@holly-cummins holly-cummins commented Apr 5, 2024

It's been a pain point for me for a while that the dev services guide, https://quarkus.io/guides/dev-services, is more of a reference which lists available dev services. The title calls it "Dev Services Overview" and we link to it in that context, but it's would be hard to learn much about dev services, just from that document. I've added a bit more information, and also a few more headings, just to visually bulk up the "this document tells you what a dev service is and how you might use it" section of the document.

The other thing this change does is resolves quarkusio/quarkusio.github.io#1869, which was created in response to quarkiverse/quarkus-wiremock#70. At the moment the decision about what dev services to include is a bit arbitrary - it's mostly platform-only, but Neo4J is in there.

Longer term, hand-curating a list of every ecosystem extension isn't very scalable, so we'll want to investigate automation, and also a solution to the "how can I find out what extensions have dev services?" question. I've raised quarkusio/extensions#983 to partially cover that requirement.

@gsmet
Copy link
Member

gsmet commented Apr 5, 2024

I think Neo4j was in there because it was part of the core repository at some point.

@holly-cummins
Copy link
Contributor Author

I think Neo4j was in there because it was part of the core repository at some point.

Yeah, I came to the same conclusion.

@quarkus-bot

This comment has been minimized.

Copy link

@oleg-nenashev oleg-nenashev left a comment

Choose a reason for hiding this comment

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

Thanks, it is definitely a good improvement 🚀

docs/src/main/asciidoc/dev-services.adoc Show resolved Hide resolved
@quarkus-bot
Copy link

quarkus-bot bot commented Apr 6, 2024

Status for workflow Quarkus Documentation CI

This is the status report for running Quarkus Documentation CI on commit 0e1733c.

✅ The latest workflow run for the pull request has completed successfully.

It should be safe to merge provided you have a look at the other checks in the summary.

Quarkus Documentation automation moved this from To do to Reviewer approved Apr 7, 2024
@gsmet gsmet merged commit 8e6d675 into quarkusio:main Apr 7, 2024
5 checks passed
Quarkus Documentation automation moved this from Reviewer approved to Done Apr 7, 2024
@quarkus-bot quarkus-bot bot added this to the 3.10 - main milestone Apr 7, 2024
@gsmet
Copy link
Member

gsmet commented Apr 7, 2024

Nice, thanks!

Copy link

github-actions bot commented Apr 7, 2024

🙈 The PR is closed and the preview is expired.

@holly-cummins holly-cummins deleted the dev-services-ecosystem branch April 8, 2024 21:27
@gsmet gsmet modified the milestones: 3.10 - main, 3.9.3 Apr 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

Proposal: include community/Quarkiverse dev services on https://quarkus.io/guides/dev-services
3 participants