Skip to content

Make a first pass at some structural introduction docs #4076

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

martinlocklear
Copy link
Contributor

@martinlocklear martinlocklear commented Apr 21, 2025

Description

As I was wrapping my head around the project it wasn't very obvious to me what the high level structures of the project where (for example - what are the most important words?) These two docs try to provide what I think I probably would have appreciated when I started digging in.

The two docs are:

  • docs/process_flow.md - Gives a high level overview of how trufflehog injests and processes sources
  • docs/concurrency.md - Tries to give a big picture overview of the concurrency structure that trufflehog uses, including the primary channels

Also added a couple quick links from likely jumping off points in existing docs/code

Diagrams can be more easily viewed here (than the code in the PR):

Checklist:

  • Tests passing (make test-community)?
  • Lint passing (make lint this requires golangci-lint)?

@martinlocklear martinlocklear marked this pull request as ready for review April 21, 2025 21:25
@martinlocklear martinlocklear requested review from a team as code owners April 21, 2025 21:25
As I was wrapping my head around the project it wasn't very obvious to me what the high level
structures of the project where (for example - what are the most important words?) These two
docs try to provide what I think I probably would have appreciated when I started digging in.

The two docs are:

* docs/process_flow.md - Gives a high level overview of how trufflehog injests and processes
			 sources
* docs/concurrency.md - Tries to give a big picture overview of the concurrency structure that
			trufflehog uses, including the primary channels

Also added a couple quick links from likely jumping off points in existing docs/code
@martinlocklear
Copy link
Contributor Author

I think it's worth highlighting that I created a new top level directory docs in this commit.

Copy link
Collaborator

@rosecodym rosecodym left a comment

Choose a reason for hiding this comment

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

lgtm!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants