This document will help getting started contributing to Verible. Collecting development aids and design concepts.
https://cs.opensource.google/verible/verible is a search-indexed mirror of Verible's source code. Expect to spend a lot of time here as you familiarize yourself with the codebase.
https://developers.google.com/code-search/reference provides a reference for search syntax and more.
To learn more about how to use Kythe to index the source code yourself, read here.
- Read the test code. Most
.hand.ccfiles come with a_test.ccset of unit tests. The tests are never outdated because they are kept passing. - Find examples. Dig through history. Follow blame and annotation layers to see when particular lines of code were touched. Look for related closed issues and see the commits that addressed them.
Each directory in the source tree contains a short README.md describing the contents.
- common/ contains all language-agnostic libraries and tools
- verilog/ contains Verilog-specific libraries and tools
- external_libs/ contains some library dependencies
- Formatter: How the formatter works, and how to debug it.