apache / apache/ponymail-foal

Is domain required here?

Open
#40 5 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
45
Forks
23
PR merge metrics
No merged PRs in 30d

Description

https://github.com/apache/incubator-ponymail-foal/blob/52fdd4b6f373c22a43932b81e46e6b84aabecdb1/server/openapi.yaml#L69

Is the domain required?

AFAICT, if it is not provided, then list is assumed to contain listname@fqdn [1]

Not sure if is a good idea, but if it is to be kept, it needs to be fully documented.

[1] https://github.com/apache/incubator-ponymail-foal/blob/52fdd4b6f373c22a43932b81e46e6b84aabecdb1/server/plugins/defuzzer.py#L83

Contributor guide

No contributing guide indexed for this repository

Research direction

Read server/openapi.yaml at line 69 and server/plugins/defuzzer.py at line 83 to compare the declared domain requirement with the fallback behavior described in the issue. Confirm the intended behavior and document whether domain is required, including the assumed listname@fqdn behavior if it is omitted.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi, python
Domain
api, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.