Internal change

PiperOrigin-RevId: 642194849

Author: Endpoints Runtime Team

.bazelrc

@@ -1,6 +1,5 @@
-Copyright 2023 Google Inc. All rights reserved.
 
-                                Apache License
+                                 Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
 
@@ -180,15 +179,15 @@ Copyright 2023 Google Inc. All rights reserved.
    APPENDIX: How to apply the Apache License to your work.
 
       To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "{}"
+      boilerplate notice, with the fields enclosed by brackets "[]"
       replaced with your own identifying information. (Don't include
       the brackets!)  The text should be enclosed in the appropriate
       comment syntax for the file format. We also recommend that a
       file or class name and description of purpose be included on the
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2016 Google Inc
+   Copyright [yyyy] [name of copyright owner]
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
@@ -200,4 +199,4 @@ Copyright 2023 Google Inc. All rights reserved.
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
+   limitations under the License.

.bazelversion

@@ -1,5 +1,37 @@
 # proto-processing-lib
 
-proto-processing-lib is a library that provides utility functionality for proto field scrubbing.
+proto-processing-lib is a library that provides utility functionality for proto
+field scrubbing.
 
-This folder is the source-of-truth.
+## FieldMask AIP-161 compatibility
+
+The field mask implementation in this library currently has some minor
+inconsistencies with the [AIP-161](https://google.aip.dev/161) specification,
+particularly around resource update behavior. While the current functionality is
+robust for most use cases, please be aware of this nuance when working with
+field masks in your applications.
+
+### Proto Processing Library's Field Mask Implementation: Differences from [AIP-161](https://google.aip.dev/161) Standard
+
+Proto Processing Library's implementation of field masks diverges from the
+AIP-161 standard in the following key ways. This table summarizes the
+similarities/differences:
+
+| Feature          | AIP-161 (Standard)          | Library Implementation     |
+| :--------------- | :-------------------------- | :------------------------- |
+| Repeated fields  | Restricted except at path   | No restriction, allowed on |
+:                  : end                         : non-leaf nodes             :
+| Map keys         | String or integer           | String (escaped)           |
+| Wildcards        | Supported for repeated      | Supported                  |
+:                  : fields/maps                 :                            :
+| Struct traversal | Supported using '.'         | Supported                  |
+| Map traversal    | Supported using '.', keys:  | Supported (string/int      |
+:                  : string/int                  : keys), '.' insertion not   :
+:                  :                             : supported                  :
+| Validation       | Ignore invalid reads, error | Error on invalid field     |
+:                  : on writes                   : names                      :
+| Update behavior  | Read after masked update    | Not supported              |
+:                  : returns same                :                            :
+| Intersection     | Not explicitly mentioned    | Supported, returns         |
+:                  :                             : intersection of two        :
+:                  :                             : FieldMask trees            :