You are viewing a plain text version of this content. The canonical link for it is here.

Posted to issues@mesos.apache.org by "Benjamin Bannier (JIRA)" <ji...@apache.org> on 2017/04/07 12:48:41 UTC

[jira] [Created] (MESOS-7368) Documentation of framework role(s) in proto definition is confusing

Benjamin Bannier created MESOS-7368:
---------------------------------------

             Summary: Documentation of framework role(s) in proto definition is confusing
                 Key: MESOS-7368
                 URL: https://issues.apache.org/jira/browse/MESOS-7368
             Project: Mesos
          Issue Type: Bug
    Affects Versions: 1.2.0
            Reporter: Benjamin Bannier


The documentation for role-related fields in {{FrameworkInfo}} is confusing: the {{role}} field is marked as {{deprecated}} while the {{roles}} field is marked as {{EXPERIMENTAL}} and has an additional {{NOTE}} advising to not use this field.

This leaves users confused what field they should use in their code. Depending on how the proto definition is used {{deprecated}} might even produce (fatal) errors, while {{roles}} seems strongly discouraged.

We should clean this up to make sure users always know which field they should use.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)