site/designs/index.md

---
layout: contribute
title: Design Documents
---

# Design Documents

The design documents published here are part of a design process:

1. Design is reviewed
2. Design document is published here
3. Design is implemented

It's possible that designs change as they are implemented in practice. The
design documents published here capture the initial design, and _not_ the
ongoing changes as designs are implemented.

Always go to the [documentation](/versions/master/docs/bazel-overview.md) for
descriptions of current Bazel functionality.

## Bazel Code Style and Best Practices

* [Implementing Native Declared Provders](https://docs.google.com/document/d/1BKCBuYvf6fwmMnFu3KMWdRFysDgGCzdMiNxY_foosAM/preview) 12 April 2017

## Bazel Design Documents

<ul>
{% for doc in site.categories.designs %}
  <li><a href="{{ doc.url }}">{{ doc.title }}</a>
      {{ doc.date | date_to_long_string }}</a></li>
{% endfor %}
</ul>



## Skylark Design Documents

Changes to the Bazel build and extension language (Skylark) should go
through the [Skylark Design Process](/designs/skylark/skylark-design-process.html).

* [Parameterized Skylark Aspects](/designs/skylark/parameterized-aspects.html)
  18 April 2016
* [Declared Providers](/designs/skylark/declared-providers.html) 06 June 2016
* [Saner Skylark Sets](/designs/skylark/saner-skylark-sets.html) 25 July 2016