cloud-fan commented on code in PR #57803:
URL: https://github.com/apache/spark/pull/57803#discussion_r3749561216


##########
AGENTS.md:
##########
@@ -18,6 +18,8 @@ SQL golden file tests are managed by `SQLQueryTestSuite` and 
its variants. Read
 
 Spark Connect protocol is defined in proto files under 
`sql/connect/common/src/main/protobuf/`. Read the README there before modifying 
proto definitions.
 
+When adding members to an existing class or object, keep related kinds of code 
in sections rather than inserting into the middle of another section. A common 
layout is fields and constructors first, then the public/override API, then 
private helpers; in a test suite, tests together and helpers after them. Prefer 
appending to the matching section, or following the file's existing sectioning 
-- the common failure mode is inserting a new member next to its first use and 
splitting the surrounding section. Do not reorganize existing members unless 
the change requires it.

Review Comment:
   can you ask AI to do more research? e.g. `tests together and helpers after 
them` looks inefficient. People usually add new test cases in the end, so 
putting helpers at the end is easier to cause conflicts.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to