Eduardo Ponce created ARROW-13414:
-------------------------------------

             Summary: [C++] Review/apply guidelines for comment tags
                 Key: ARROW-13414
                 URL: https://issues.apache.org/jira/browse/ARROW-13414
             Project: Apache Arrow
          Issue Type: Improvement
          Components: C++
            Reporter: Eduardo Ponce
             Fix For: 6.0.0


The google style guide describes best practices for source code comments 
including for [TODO 
comments|https://google.github.io/styleguide/cppguide.html#TODO_Comments]. 
Nevertheless, Arrow C++ code contains comments with custom tags (*TODO*, 
*NOTE*, *N.B.*, *XXX*) which are used with varying styles and do not have an 
explicit guideline on their use/meaning.

It would be good to establish guidelines for allowed custom tags (if any) and 
their use case.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Reply via email to