diff --git a/specs/core/0_deposit-contract.md b/specs/core/0_deposit-contract.md
index 7dee6a998..af81c6bec 100644
--- a/specs/core/0_deposit-contract.md
+++ b/specs/core/0_deposit-contract.md
@@ -59,6 +59,6 @@ Every Ethereum 1.0 deposit emits a `DepositEvent` log for consumption by the bea
 
 ## Vyper code
 
-The deposit contract source code, written in Vyper, is available [here](https://github.com/ethereum/eth2.0-specs/blob/dev/deposit_contract/contracts/validator_registration.v.py).
+The deposit contract source code, written in Vyper, is available [here](../../deposit_contract/contracts/validator_registration.v.py).
 
 *Note*: To save on gas, the deposit contract uses a progressive Merkle root calculation algorithm that requires only O(log(n)) storage. See [here](https://github.com/ethereum/research/blob/master/beacon_chain_impl/progressive_merkle_tree.py) for a Python implementation, and [here](https://github.com/runtimeverification/verified-smart-contracts/blob/master/deposit/formal-incremental-merkle-tree-algorithm.pdf) for a formal correctness proof.
diff --git a/specs/simple-serialize.md b/specs/simple-serialize.md
index 7076b6410..8d9c33103 100644
--- a/specs/simple-serialize.md
+++ b/specs/simple-serialize.md
@@ -11,16 +11,22 @@
     - [Typing](#typing)
         - [Basic types](#basic-types)
         - [Composite types](#composite-types)
+        - [Variable-size and fixed-size](#variable-size-and-fixed-size)
         - [Aliases](#aliases)
         - [Default values](#default-values)
+            - [`is_empty`](#is_empty)
         - [Illegal types](#illegal-types)
     - [Serialization](#serialization)
         - [`uintN`](#uintn)
         - [`boolean`](#boolean)
         - [`null`](#null)
+        - [`Bitvector[N]`](#bitvectorn)
+        - [`Bitlist[N]`](#bitlistn)
         - [Vectors, containers, lists, unions](#vectors-containers-lists-unions)
     - [Deserialization](#deserialization)
     - [Merkleization](#merkleization)
+        - [Merkleization of `Bitvector[N]`](#merkleization-of-bitvectorn)
+        - [`Bitlist[N]`](#bitlistn-1)
     - [Self-signed containers](#self-signed-containers)
     - [Implementations](#implementations)
 
diff --git a/test_generators/bls/README.md b/test_generators/bls/README.md
index a21ad16d9..2bf46e9ea 100644
--- a/test_generators/bls/README.md
+++ b/test_generators/bls/README.md
@@ -9,7 +9,7 @@ The base unit is bytes48 of which only 381 bits are used
 
 ## Resources
 
-- [Eth2.0 spec](https://github.com/ethereum/eth2.0-specs/blob/master/specs/bls_signature.md)
+- [Eth2.0 spec](../../specs/bls_signature.md)
 - [Finite Field Arithmetic](http://www.springeronline.com/sgw/cda/pageitems/document/cda_downloaddocument/0,11996,0-0-45-110359-0,00.pdf)
 - Chapter 2 of [Elliptic Curve Cryptography](http://cacr.uwaterloo.ca/ecc/). Darrel Hankerson, Alfred Menezes, and Scott Vanstone 
 - [Zcash BLS parameters](https://github.com/zkcrypto/pairing/tree/master/src/bls12_381)