Specification for parse_kv_items and parse_kv_config
@tasosalvas is already working on this.
Since Aug 11, 2020.
- Dominant language
- Jinja
- Stars
- 1.4k
- Forks
- 379
- Avg merge
- 4d 18h
- Merged PRs (30d)
- 8
Description
parse_kv_items and parse_kv_config was introduced by @drybjed and is now a core part of DebOps. People working with DebOps need a clear understanding of it. Documentation what the filters do are contained in the actual role documentation but are specific to the role then. This will require people writing new roles to actually look into the code to figure out what it does and how to use it in their own roles. As already proposed by @tasosalvas, specification of the filters is needed defining exactly what their behavior is. I went for a hands-on approach when the filters where introduced and wrote the unit tests to reverse and "document" what they do. I would still be interested in a design document about our direction.
And maybe a "Not invented here" approach, but no better alternative comes to mind for me currently to solve all of the things that the filters do.
I just want to track this here. Again, no pressure. I know maintaining a project is hard and this is a FOSS project. My idea is more that people interested in DebOps maybe can reverse the filters as well and not write unit tests this time but think about the problem and come up with a design document.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.