Skip to content

Fixes #28374: ADR for Generic Method#6929

Draft
Fdall wants to merge 2 commits into
Normation:branches/rudder/9.1from
Fdall:arch_28374/adr_for_generic_method
Draft

Fixes #28374: ADR for Generic Method#6929
Fdall wants to merge 2 commits into
Normation:branches/rudder/9.1from
Fdall:arch_28374/adr_for_generic_method

Conversation

@Fdall
Copy link
Copy Markdown
Contributor

@Fdall Fdall commented Feb 18, 2026

Comment thread adr/system/28374-method-definition.md Outdated
@@ -0,0 +1,80 @@
# [Simpler method logger without suffix]
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
# [Simpler method logger without suffix]
# Simpler method logger without suffix

@Fdall Fdall force-pushed the arch_28374/adr_for_generic_method branch from a9d59bd to f378f73 Compare February 18, 2026 14:55
@Fdall
Copy link
Copy Markdown
Contributor Author

Fdall commented Feb 18, 2026

Commit modified

Fixes #28374: ADR for Generic Method
@Fdall
Copy link
Copy Markdown
Contributor Author

Fdall commented Feb 18, 2026

PR updated with a new commit

Copy link
Copy Markdown
Contributor

@P4uline P4uline left a comment

Choose a reason for hiding this comment

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

It's so nice to have ADR's about generic methods, it's helpful also for the webapp team. Thanks for the detailed specification.
Just have some feedbacks about ADR formatting.


**This ADR applies to all Generic Methods starting 9.1. Existing and future ones.**

## Decision:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I would say, there is too many information in the decision section so it is very difficult to understand what is the decision.
Maybe everything that is a specification could be moved in another section (Details or Examples), or even outside the repository (notion or any other tool... ) and referenced with a link ?
That way we could have only a few sentences to describe the decision which would be more clear.
WDYT ?


## Decision:

- A **Generic Method** (GM) is a configurable policy execution unit based on a declarative system
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reading more carefully, what I understand is that the actual decision would be something like :

Decision

The new generic methods must follow these guidelines:

  • naming convention
  • the return status must follow a pattern (see details)
  • foreach loop case: keep the worst case
  • have a companion agent bundle file
  • have mandatory fields
  • return a Rudder report

see detailed specification

It just a proposal, but it would be nice to keep the decision section simple and small :)

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