Put an explicit warning about the incovenience of working against main and a recommendation to use a supported release in the root readme.

PiperOrigin-RevId: 613234330
pull/16073/head
Protobuf Team Bot 2024-03-06 08:59:05 -08:00 committed by Copybara-Service
parent 554a00c40a
commit 53ad6a4478
1 changed files with 17 additions and 0 deletions

View File

@ -16,6 +16,23 @@ This README file contains protobuf installation instructions. To install
protobuf, you need to install the protocol compiler (used to compile .proto
files) and the protobuf runtime for your chosen programming language.
Working With Protobuf Source Code
---------------------------------
Most users will find working from
[supported releases](https://github.com/protocolbuffers/protobuf/releases) to be
the easiest path.
If you choose to work from the head revision of the main branch your build will
occasionally be broken by source-incompatible changes and insufficiently-tested
(and therefore broken) behavior.
If you are using C++ or otherwise need to build protobuf from source as a part
of your project, you should pin to a release commit on a release branch.
This is because even release branches can experience some instability in between
release commits.
Protobuf Compiler Installation
------------------------------