Skip to content

Conversation

@garlick
Copy link
Member

@garlick garlick commented Jan 7, 2026

Problem: RFC 5 is pretty of date at this point.

Make an update pass.

@github-actions
Copy link

github-actions bot commented Jan 7, 2026

⚠️ linkcheck failed with status code 2

GitHub is NOT the preferred viewer for this file. Please visit
https://flux-framework.rtfd.io/projects/flux-rfc/en/latest/spec_5.html
5/Flux Broker Modules
Copy link
Member

Choose a reason for hiding this comment

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

commit message "out of date" :-)

spec_5.rst Outdated
Comment on lines 126 to 127
The colon-separated list of directories that SHOULD be searched for PATH
if it is not fully-qualified.
Copy link
Member

@chu11 chu11 Jan 8, 2026

Choose a reason for hiding this comment

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

this section read funny to me, then I figured out what was confusing. Suggestion:

Do flux-module-exec MODULE

(aside, should you mention ARGS too?)

Then

The colon-separated list of directories that SHOULD be searched for MODULE if it not fully qualified

When I read "SHOULD be searched for PATH" for the environment variable "FLUX_MODULE_PATH", I was confused.

Comment on lines 141 to 145
The module name SHALL be registered as a default service provided by the
module. This means that request messages with topic strings that begin
with ``NAME.`` are routed to the module for handling. Additional services
MAY be dynamically registered by the module.
Copy link
Member

Choose a reason for hiding this comment

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

perhaps add an example, like kvs.lookup and kvs.commit are both routed to the kvs module?


Module Attributes

Module Management
Copy link
Member

@chu11 chu11 Jan 8, 2026

Choose a reason for hiding this comment

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

should there be some introductory text in this section? For each RPC?

mildly related, should the registering/unregistering of services in modules be here? Or for another RFC?

Copy link
Member Author

Choose a reason for hiding this comment

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

I think elsewhere since it's not a requirement that the entity registering the service be a module.

@garlick
Copy link
Member Author

garlick commented Jan 8, 2026

Thanks, great suggestions. Sorry I think I kind of ran out of gas towards the end there.
OK, pushed responses to your review as a fixup in case you'd like to see what changed.

@github-actions
Copy link

github-actions bot commented Jan 8, 2026

⚠️ linkcheck failed with status code 2

Copy link
Member

@chu11 chu11 left a comment

Choose a reason for hiding this comment

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

the changes LGTM!

Problem: RFC 5 is out of date.

Make an update pass.
@mergify mergify bot added the queued label Jan 9, 2026
@mergify mergify bot merged commit 66fa7ee into flux-framework:master Jan 9, 2026
7 checks passed
@mergify
Copy link
Contributor

mergify bot commented Jan 9, 2026

Merge Queue Status

✅ The pull request has been merged at cfe43ed

This pull request spent 5 seconds in the queue, with no time running CI.
The checks were run in-place.

Required conditions to merge
  • any of [🛡 GitHub branch protection]:
    • check-success = docs/readthedocs.org:flux-rfc
    • check-neutral = docs/readthedocs.org:flux-rfc
    • check-skipped = docs/readthedocs.org:flux-rfc
  • any of [🛡 GitHub branch protection]:
    • check-success = make check
    • check-neutral = make check
    • check-skipped = make check
  • any of [🛡 GitHub branch protection]:
    • check-success = validate commits
    • check-neutral = validate commits
    • check-skipped = validate commits

@mergify mergify bot removed the queued label Jan 9, 2026
@garlick garlick deleted the rfc5_update branch January 9, 2026 17:30
@github-actions
Copy link

github-actions bot commented Jan 9, 2026

⚠️ linkcheck failed with status code 2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants