Skip to content

Question: Terms "measures" and "controls" mixed up in backend? #659

@zeocs

Description

@zeocs

Hello,

I plan to make a couple of contributions to Deming and I'm making myself familiar with the codebase right now. One thing that confuses me is the naming of "measures" and "controls. It seems as if their names should be the other way round in the backend... if I am not mistaken? I read Issue #516 where someone asked about alice and bob. I suspect that in various places in the backend, it may have been named after the french terms initially and then kept like this, so there's a mix-up for historic reasons, is that right by any chance?

In the fontend:

  • Controls = Maßnahmen = Mesures = URL "alice/"
  • Measurements = Kontrollen = Contrôles = URL "bob/"

But for example, in routes/web.php it seems to be mixed up (from an English perspective):

  • /alice/* is handled by MeasureController
  • /bob/* is handled by ControlController
  • MeasureController queries database table controls and returns the results
  • ControlController queries database table measures and returns the results

Or in resources/views/control/show.blade.php:

@foreach($control->controls as $measure)
    <a href="/alice/show/{{ $measure->id }}">{{ $measure->clause }}</a> - {{ $measure->name }}
    @if(!$loop->last)
    <br>
    @endif
@endforeach

The database table names seem correct.

English is the odd one out among the languages. But since the backend code is primarily in English, the naming should be consistent. At least that's what I think.

Am I correct in my observations?
If so, do you plan to fix this? Would you accept a PR that fixes this?
Or maybe, in the mean time, this should be documented somewhere to avoid new developers.

Kind regards

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions