Add deprecation warning, links to V1 docs in new (V1+V2) gitbook space (#17)

markusbkoch · web-flow · commit ef7ea7c4ef45 · 2021-08-03T16:26:08.000-03:00
diff --git a/api/api.md b/api/api.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/api/api)
+
 # API Index
 
 | Function |
diff --git a/api/core-contracts.md b/api/core-contracts.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/api/core-contracts)
+
 # Events
 
 ### Events
diff --git a/api/migration-to-version-0.4.md b/api/migration-to-version-0.4.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/api/migration-to-version-0.4)
+
 # Migration to Version 1.0
 
 The SOR Version 1.0.0-0 introduces breaking changes but should be fairly easy to update. Benefits of updating include - support for multihop swaps and an easier to use wrapper interface as well as more efficient/faster processing.
diff --git a/api/uml-docs.md b/api/uml-docs.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/api/uml-docs)
+
 # UML Docs
 
 * [BPool](https://drive.google.com/file/d/1qta1KBLRq_8GZJ_dTL0zo2HYPD_dYUrH/view?usp=sharing)
diff --git a/core-concepts/bal-balancer-governance-token/README.md b/core-concepts/bal-balancer-governance-token/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/bal-balancer-governance-token/)
+
 # BAL Governance Token
 
 Since inception, our goal at Balancer Labs has been to decentralize and diversify governance of the [Balancer Protocol](http://balancer.finance/). We have looked into several approaches and designs, and have landed on an approach we are proud to share: the Balancer Protocol Governance Token \(BAL\).
diff --git a/core-concepts/bal-balancer-governance-token/bal-for-gas.md b/core-concepts/bal-balancer-governance-token/bal-for-gas.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/bal-balancer-governance-token/bal-for-gas)
+
 # BAL for Gas
 
 Following a 6 week pilot, on March 7th 2021 the Balancer community approved a campaign to increase BAL distribution. To ensure lasting robustness of the governance process, both liquidity providers and traders should have a say in how the protocol evolves.
diff --git a/core-concepts/bal-liquidity-mining/README.md b/core-concepts/bal-liquidity-mining/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/bal-liquidity-mining/)
+
 # Liquidity Mining
 
 ## BAL Distribution Proportional to Liquidity on Balancer <a id="353e"></a>
diff --git a/core-concepts/bal-liquidity-mining/exchange-and-reward-listing.md b/core-concepts/bal-liquidity-mining/exchange-and-reward-listing.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/bal-liquidity-mining/exchange-and-reward-listing)
+
 # Exchange and BAL Mining Listing
 
 Token listings are managed in [this repository](https://github.com/balancer-labs/assets), with the following categories:
diff --git a/core-concepts/bal-liquidity-mining/liquidity-mining-estimates-api.md b/core-concepts/bal-liquidity-mining/liquidity-mining-estimates-api.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/bal-liquidity-mining/liquidity-mining-estimates-api)
+
 # Liquidity Mining Estimates API
 
 ## Liquidity Mining Estimates API
diff --git a/core-concepts/protocol/README.md b/core-concepts/protocol/README.md
@@ -1,2 +1,4 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/protocol/)
+
 # Protocol
 
diff --git a/core-concepts/protocol/background-1.md b/core-concepts/protocol/background-1.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/protocol/background-1)
+
 # Background
 
 Automated Market Makers \(AMMs\) have been around in some form for as long as trades could be automated, starting in the traditional financial markets. AMMs are essentially automated agents, controlled by algorithms, that define rules for matching buyers and sellers to facilitate trades. Usually AMMs are continuously active in both directions of a trading pair. The liquidity provider's profit comes  from the spread between buy and sell prices.
diff --git a/core-concepts/protocol/glossary.md b/core-concepts/protocol/glossary.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/protocol/glossary)
+
 # Glossary
 
 * **Core Pool**: A `BPool` contract object - this is the "base" pool that actually holds the tokens
diff --git a/core-concepts/protocol/index/README.md b/core-concepts/protocol/index/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/protocol/index/)
+
 # Math
 
 The [Balancer whitepaper](https://balancer.finance/whitepaper.html) describes a set of formulas derived from the value function for interacting with the protocol. The formulas in the Theory section are sufficient to describe the functional specification, but they are not straightforward to implement for the EVM, in part due to a lack of mature fixed-point math libraries.
diff --git a/core-concepts/protocol/index/approxing.md b/core-concepts/protocol/index/approxing.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/protocol/index/approxing)
+
 # Exponentiation
 
 The main formulas used in Balancer protocol make use of a form of exponentiation where both the base and exponent are fixed-point \(non-integer\) values. Take for example the `swap` functions, where the weights in both the exponent and the base are fractions:
diff --git a/core-concepts/protocol/limitations.md b/core-concepts/protocol/limitations.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/protocol/limitations)
+
 # Limitations
 
 Balancer is meant to be a flexible and agnostic DeFi primitive. Due to constraints such as gas and math approximations, there are some limitations built into the protocol.
diff --git a/core-concepts/protocol/pool-lifecycle.md b/core-concepts/protocol/pool-lifecycle.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/protocol/pool-lifecycle)
+
 # Pool Lifecycle
 
 Any user can create a new pool by calling `newBPool()` on the `BFactory` contract. The caller is set as the `controller` or pool owner.
diff --git a/core-concepts/security/README.md b/core-concepts/security/README.md
@@ -1,2 +1,4 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/security/)
+
 # Security
 
diff --git a/core-concepts/security/audits.md b/core-concepts/security/audits.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/security/audits)
+
 ---
 description: Audits of the balance-core smart contracts
 ---
diff --git a/core-concepts/security/bounty.md b/core-concepts/security/bounty.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/core-concepts/security/bounty)
+
 # Bug Bounty
 
 ### Overview
diff --git a/getting-started/faq.md b/getting-started/faq.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/getting-started/faq)
+
 # FAQ
 
 ## Basics
diff --git a/getting-started/use-cases.md b/getting-started/use-cases.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/getting-started/use-cases)
+
 # Use Cases
 
 There are two categories of users who can benefit from the Balancer Protocol: liquidity providers - who own Balancer Pools or participate in shared pools, and traders - who buy or sell the underlying pool assets on the open market.
diff --git a/guides/creating-a-balancer-pool.md b/guides/creating-a-balancer-pool.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/creating-a-balancer-pool)
+
 # Creating a Shared Pool
 
 ## Setting up a proxy
diff --git a/guides/creating-a-smart-pool.md b/guides/creating-a-smart-pool.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/creating-a-smart-pool)
+
 # Creating a Smart Pool
 
 ## Setting up a proxy
diff --git a/guides/crp-tutorial.md b/guides/crp-tutorial.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/crp-tutorial)
+
 # CRP Tutorial
 
 Similar to Core Pools, Configurable Rights Pools are created from a public factory. Refer to [Addresses](../smart-contracts/addresses.md) to find the contract on your network of choice.
diff --git a/guides/crp-tutorial/README.md b/guides/crp-tutorial/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/crp-tutorial/)
+
 # CRP Tutorial
 
 Similar to Core Pools, Configurable Rights Pools are created from a public factory. Refer to [Addresses](../../smart-contracts/addresses.md) to find the contract on your network of choice.
diff --git a/guides/crp-tutorial/liquidity-bootstrapping.md b/guides/crp-tutorial/liquidity-bootstrapping.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/crp-tutorial/liquidity-bootstrapping)
+
 # Liquidity Bootstrapping Example
 
 Let's walk through a complete example, using the [Liquidity Bootstrapping](https://balancer.finance/2020/03/04/building-liquidity-into-token-distribution/) use case. There is also extensive higher-level discussion in the [Liquidity Bootstrapping FAQ](../../smart-contracts/smart-pools/liquidity-bootstrapping-faq.md).
diff --git a/guides/hackathons/README.md b/guides/hackathons/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/hackathons/)
+
 # Hackathons
 
 This section provides resources and info for everyone who is hacking and building on Balancer - the potentail is huge and we're excited to see what you create!
diff --git a/guides/hackathons/hacking-and-testing.md b/guides/hackathons/hacking-and-testing.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/hackathons/hacking-and-testing)
+
 ---
 description: Some useful specifics to get you started
 ---
diff --git a/guides/hackathons/ideas.md b/guides/hackathons/ideas.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/hackathons/ideas)
+
 # Ideas
 
 We’re excited to see what you could build and to get you started here’s some ideas:
diff --git a/guides/hackathons/judging.md b/guides/hackathons/judging.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/hackathons/judging)
+
 ---
 description: Some things we like to see (i.e. help yourself to win)
 ---
diff --git a/guides/liquidity-bootstrapping-faq.md b/guides/liquidity-bootstrapping-faq.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/liquidity-bootstrapping-faq)
+
 # Liquidity Bootstrapping FAQ
 
 ### How do I launch a Liquidity Bootstrapping Pool?
diff --git a/guides/liquidity-bootstrapping.md b/guides/liquidity-bootstrapping.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/liquidity-bootstrapping)
+
 # Liquidity Bootstrapping Example
 
 Let's walk through a complete example, using the [Liquidity Bootstrapping](https://balancer.finance/2020/03/04/building-liquidity-into-token-distribution/) use case.
diff --git a/guides/making-a-trade.md b/guides/making-a-trade.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/making-a-trade)
+
 # Using the SOR
 
 WIP
diff --git a/guides/smart-pool-templates-gui/README.md b/guides/smart-pool-templates-gui/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/smart-pool-templates-gui/)
+
 # Smart Pool Use Cases
 
 Here we detail several applications of the core Configurable Rights Pool, and show how you would configure your custom pool \(on creation from the factory\), to accommodate each use case. \(Eventually we will have a GUI wizard to guide you through this process.\)
diff --git a/guides/smart-pool-templates-gui/experimental.md b/guides/smart-pool-templates-gui/experimental.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/smart-pool-templates-gui/experimental)
+
 # Experimental
 
 If you've been in the crypto space since 2017, you'll remember well the ICO hype. People were throwing money at every new token with a website. \(If you're just a bit older, you'll remember the .com boom of '99 as well - when it was every company with a website.\)
diff --git a/guides/smart-pool-templates-gui/investors-club.md b/guides/smart-pool-templates-gui/investors-club.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/smart-pool-templates-gui/investors-club)
+
 # Investors' Club
 
 With Smart Pools, it is possible to restrict liquidity providers to a defined group. For instance, accredited investors, or those who have complied with a KYC process \(e.g., for STOs\). However, the privileged addresses could be determined by anything - holders of certain tokens, those who participated in community building or voting, winners of a "lottery" for investment slots, etc.
diff --git a/guides/smart-pool-templates-gui/liquidity-bootstrapping-pool.md b/guides/smart-pool-templates-gui/liquidity-bootstrapping-pool.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/smart-pool-templates-gui/liquidity-bootstrapping-pool)
+
 # Liquidity Bootstrapping Pool
 
 Here is the [article](https://balancer.finance/2020/03/04/building-liquidity-into-token-distribution/) describing this common case - basically a sustainable 2020 reboot of the 2017 "ICO" - minus the worst of the legal and regulatory issues. \(The latest term seems to be IDO - Initial DEX Offering.\)
diff --git a/guides/smart-pool-templates-gui/perpetual-synthetic-pool.md b/guides/smart-pool-templates-gui/perpetual-synthetic-pool.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/smart-pool-templates-gui/perpetual-synthetic-pool)
+
 # Perpetual Synthetic Pool
 
 Synthetic tokens, through the efforts of [UMA](https://umaproject.org/) and others, are coming into their own, grabbing the spotlight and bringing a type of derivative familiar from the traditional financial markets to crypto.
diff --git a/guides/smart-pool-templates-gui/smart-treasury.md b/guides/smart-pool-templates-gui/smart-treasury.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/smart-pool-templates-gui/smart-treasury)
+
 # Smart Treasury
 
 This is an emerging use case, based in large part on [this article](https://www.placeholder.vc/blog/2020/9/17/stop-burning-tokens-buyback-and-make-instead) by Placeholder \(see image below, from that article, and the related [simulator](https://drive.google.com/file/d/1xTyQAQgTyl6Ajkl7AYzA6yB_X2H-5RVn/view).\)
diff --git a/guides/smart-pool-templates-gui/swing-trading-pool.md b/guides/smart-pool-templates-gui/swing-trading-pool.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/smart-pool-templates-gui/swing-trading-pool)
+
 # Swing Trading Pool
 
 Recall the basic design of investment pools: traders profit through arbitrage opportunities, created when "internal" prices diverge from token market values, and pay fees for the privilege, which accrue to the liquidity providers.
diff --git a/guides/testing-on-kovan.md b/guides/testing-on-kovan.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/testing-on-kovan)
+
 # Testing on Kovan
 
 ## Overview
diff --git a/guides/withdrawing-liquidity-via-etherscan.md b/guides/withdrawing-liquidity-via-etherscan.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/guides/withdrawing-liquidity-via-etherscan)
+
 # Interact via Etherscan
 
 Our UI allows for any liquidity provider to withdraw liquidity by clicking on the button "Remove Liquidity" on the detailed pool view page. This article though focus on how to withdraw liquidity without our UI \(in case it is down or inaccessible\). To do that we'll be using Etherscan.io.
diff --git a/index.md b/index.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/index)
+
 # Home
 
 _Looking for the V2 docs? --&gt;_ [_https://docs-v2.balancer.finance/_](https://docs-v2.balancer.finance/)\_\_
diff --git a/protocol/background.md b/protocol/background.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/background)
+
 # Background
 
 Automated Market Makers \(AMMs\) have been around in some form for as long as trades could be automated, starting in the traditional financial markets. AMMs are essentially automated agents, controlled by algorithms, that define rules for matching buyers and sellers to facilitate trades. Usually AMMs are continuously active in both directions of a trading pair. The liquidity provider's profit comes  from the spread between buy and sell prices.
diff --git a/protocol/bal-balancer-governance-token.md b/protocol/bal-balancer-governance-token.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/bal-balancer-governance-token)
+
 # BAL - Balancer Governance Token
 
 Since inception, our goal at Balancer Labs has been to decentralize and diversify governance of the [Balancer Protocol](http://balancer.finance/). We have looked into several approaches and designs, and have landed on an approach we are proud to share: the Balancer Protocol Governance Token \(BAL\).
diff --git a/protocol/bal-liquidity-mining/README.md b/protocol/bal-liquidity-mining/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/bal-liquidity-mining/)
+
 # BAL Liquidity Mining
 
 ## BAL Distribution Proportional to Liquidity on Balancer <a id="353e"></a>
diff --git a/protocol/bal-liquidity-mining/exchange-and-reward-listing.md b/protocol/bal-liquidity-mining/exchange-and-reward-listing.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/bal-liquidity-mining/exchange-and-reward-listing)
+
 # Exchange and Reward Listing
 
 Token listings are managed in [this repository](https://github.com/balancer-labs/assets), with the following categories:
diff --git a/protocol/btoken.md b/protocol/btoken.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/btoken)
+
 # BPTs
 
 All pools in Balancer are also ERC20 tokens known as BPTs \(Balancer Pool Tokens\), which represent proportional ownership in the pool's liquidity. When users add liquidity through `joinPool` or `joinswap*` they receive BPTs proportional to the amount of assets they are adding to the pool.
diff --git a/protocol/concepts.md b/protocol/concepts.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/concepts)
+
 # Core Concepts
 
 ## Terminology
diff --git a/protocol/index/README.md b/protocol/index/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/index/)
+
 # Math
 
 The [Balancer whitepaper](https://balancer.finance/whitepaper.html) describes a set of formulas derived from the value function for interacting with the protocol. The formulas in the Theory section are sufficient to describe the functional specification, but they are not straightforward to implement for the EVM, in part due to a lack of mature fixed-point math libraries.
diff --git a/protocol/index/approxing.md b/protocol/index/approxing.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/index/approxing)
+
 # Exponentiation
 
 The main formulas used in Balancer protocol make use of a form of exponentiation where both the base and exponent are fixed-point \(non-integer\) values. Take for example the `swap` functions, where the weights in both the exponent and the base are fractions:
diff --git a/protocol/limitations.md b/protocol/limitations.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/limitations)
+
 # Limitations
 
 Balancer is meant to be a flexible and agnostic DeFi primitive. Due to constraints such as gas and math approximations, there are some limitations built into the protocol.
diff --git a/protocol/security/README.md b/protocol/security/README.md
@@ -1,2 +1,4 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/security/)
+
 # Security
 
diff --git a/protocol/security/audits.md b/protocol/security/audits.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/security/audits)
+
 ---
 description: Audits of the balance-core smart contracts
 ---
diff --git a/protocol/security/bounty.md b/protocol/security/bounty.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/security/bounty)
+
 # Bug Bounty
 
 ### Overview
diff --git a/protocol/sor.md b/protocol/sor.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/sor)
+
 # SOR
 
 ## Overview
diff --git a/protocol/sor/README.md b/protocol/sor/README.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/sor/)
+
 # SOR
 
 ## Overview
diff --git a/protocol/sor/developing.md b/protocol/sor/developing.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/protocol/sor/developing)
+
 # Developing
 
 WIP - still needs to be cleaned up
diff --git a/smart-contracts/addresses.md b/smart-contracts/addresses.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/smart-contracts/addresses)
+
 # Addresses
 
 ## Mainnet
diff --git a/smart-contracts/api.md b/smart-contracts/api.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/smart-contracts/api)
+
 # API \(Core BPool\)
 
 ## API Index
diff --git a/smart-contracts/component-libraries.md b/smart-contracts/component-libraries.md
@@ -1,3 +1,5 @@
+# This page has been deprecated. V1 documentation is partially maintained [here](https://docs.balancer.fi/v/v1/smart-contracts/component-libraries)
+
 # Component Libraries
 
 The Configurable Rights Pool uses several externally linked libraries to implement all its functionality, detailed below.
diff --git a/smart-contracts/configurable-rights-pool.md b/smart-contracts/configurable-rights-pool.md
diff --git a/smart-contracts/core-contracts/README.md b/smart-contracts/core-contracts/README.md
diff --git a/smart-contracts/core-contracts/api.md b/smart-contracts/core-contracts/api.md
diff --git a/smart-contracts/crp-class-diagram.md b/smart-contracts/crp-class-diagram.md
diff --git a/smart-contracts/exchange-proxy.md b/smart-contracts/exchange-proxy.md
diff --git a/smart-contracts/index.md b/smart-contracts/index.md
diff --git a/smart-contracts/interfaces.md b/smart-contracts/interfaces.md
diff --git a/smart-contracts/on-chain-registry.md b/smart-contracts/on-chain-registry.md
diff --git a/smart-contracts/rights-manager.md b/smart-contracts/rights-manager.md
diff --git a/smart-contracts/smart-pool-templates.md b/smart-contracts/smart-pool-templates.md
diff --git a/smart-contracts/smart-pools/README.md b/smart-contracts/smart-pools/README.md
diff --git a/smart-contracts/smart-pools/component-libraries.md b/smart-contracts/smart-pools/component-libraries.md
diff --git a/smart-contracts/smart-pools/component-libraries/README.md b/smart-contracts/smart-pools/component-libraries/README.md
diff --git a/smart-contracts/smart-pools/component-libraries/rights-manager.md b/smart-contracts/smart-pools/component-libraries/rights-manager.md
diff --git a/smart-contracts/smart-pools/concepts.md b/smart-contracts/smart-pools/concepts.md
diff --git a/smart-contracts/smart-pools/configurable-rights-pool.md b/smart-contracts/smart-pools/configurable-rights-pool.md
diff --git a/smart-contracts/smart-pools/liquidity-bootstrapping-faq.md b/smart-contracts/smart-pools/liquidity-bootstrapping-faq.md
diff --git a/smart-contracts/smart-pools/rights-manager.md b/smart-contracts/smart-pools/rights-manager.md
diff --git a/smart-contracts/smart-pools/smart-pool-templates.md b/smart-contracts/smart-pools/smart-pool-templates.md
diff --git a/smart-contracts/sor/README.md b/smart-contracts/sor/README.md
diff --git a/smart-contracts/sor/development.md b/smart-contracts/sor/development.md
diff --git a/sor/development.md b/sor/development.md
diff --git a/sor/migration-to-version-0.4.md b/sor/migration-to-version-0.4.md
