Skip to content
This repository has been archived by the owner on Jan 28, 2021. It is now read-only.

docs: document the architecture of the project #651

Merged
merged 1 commit into from
Apr 8, 2019

Conversation

erizocosmico
Copy link
Contributor

Signed-off-by: Miguel Molina miguel@erizocosmi.co

@erizocosmico erizocosmico requested a review from a team April 3, 2019 16:13
ARCHITECTURE.md Outdated
@@ -0,0 +1,137 @@
# Architecture overview

This document provides an overview of all parts and pueces of the project as well as how they fit together. It is meant to help new contributors understand where things may be, and how changes in some components may interact with other components of the system.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pueces := pieces

ARCHITECTURE.md Outdated
This is where the engine lives. The engine is the piece that coordinates and makes all other pieces work together as well as the main API users of the system will use to create and configure an engine and perform queries.

Because this is the point where all components fit together, it is also where integration tests are. Those integration tests can be found in `engine_test.go`.
Every time a feature is added or a bug that comes from a particular query is fixed, a test should be added there.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe: "a test should be added there, plus in any specific where the feature/issue belonged, if needed".

ARCHITECTURE.md Outdated

### `sql/analyzer`

The analyzer is perhaps the more complex component of the project. It contains a main component, which is the `Analyzer`, in charge of executing its registered rules on execution trees for resolving some parts, removing redundant data, optimizing things for performance, etc.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe without "perphaps" :) because IMO it's the more complex one by a long shot.

@erizocosmico erizocosmico self-assigned this Apr 4, 2019
Signed-off-by: Miguel Molina <miguel@erizocosmi.co>
@erizocosmico
Copy link
Contributor Author

Requested changes fixed

@ajnavarro ajnavarro merged commit caa2047 into src-d:master Apr 8, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants