sdl_core icon indicating copy to clipboard operation
sdl_core copied to clipboard

Report on HMI_API.xml issues(inaccurate description)

Open Yuki-Shoda-Nexty opened this issue 5 years ago • 7 comments

Report on HMI_API.xml issues(inaccurate description)

We suggest correcting HMI_API.xml(inaccurate description)

Currently, HMI_API.xml contains some inaccurate descriptions. . By compensating for this, we can provide a more accurate RPC documents to the SDL developers. The target items are described in the Excel file.

HMI_API_inaccurate description.xlsx

e.g. alignment that is one of the parameter of RPC Show in HMI_API.xml, its description is inaccurate. Add the description of each element as shown below.

Modify the description of alignment as shown below.

     <param name="alignment" type="TextAlignment" mandatory="false" since="1.0">
       <description>
-        Specifies how mainField1 and mainField2 texts should be aligned on display.
+        Specifies how mainField1, mainField2, mainField3 and mainField4 texts should be aligned on display.
         .If omitted, texts will be centered.
       </description>
     </param>

Yuki-Shoda-Nexty avatar May 29 '20 02:05 Yuki-Shoda-Nexty

@theresalech -san Would this be a good way to report document problems?

Yuki-Shoda-Nexty avatar May 29 '20 02:05 Yuki-Shoda-Nexty

Hi @Yuki-Shoda-Nexty, yes this is a good way to report issues with the HMI_API.xml. Can you please confirm that this issue contains all inaccurate descriptions within the HMI_API.xml? If so, please submit a PR to fix the descriptions/resolve the issue, and the PM can review. Thank you!

theresalech avatar Jun 02 '20 14:06 theresalech

@theresalech -san, Fixed description and example in the Bug Report.

Yuki-Shoda-Nexty avatar Jun 04 '20 01:06 Yuki-Shoda-Nexty

@Yuki-Shoda-Nexty, thank you! Please advise when a PR has been entered to resolve the issue

theresalech avatar Jun 04 '20 12:06 theresalech

@theresalech -san We have already finished confirmation of the issues you indicated. We do not propose it as PR, but we will report it on the issue page instead. We would like PM to fix the issue by using the information on issue page as reference.

Yuki-Shoda-Nexty avatar Jun 08 '20 06:06 Yuki-Shoda-Nexty

@Yuki-Shoda-Nexty understood, thank you. This issue has not been raised as high priority for the upcoming release by any Steering Committee members, but the Project Maintainer will work to resolve the issue as time allows.

theresalech avatar Jun 08 '20 15:06 theresalech

@theresalech -san, Thank you! If you have any questions, feel free to comment.

Yuki-Shoda-Nexty avatar Jun 09 '20 00:06 Yuki-Shoda-Nexty