Skip to content
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

Documentation improvements - Internal Architecture Doc + Package level comments #10068

Merged
merged 14 commits into from
May 20, 2024

Conversation

ankitpatel96
Copy link
Contributor

@ankitpatel96 ankitpatel96 commented May 1, 2024

Documentation

Creates an internal architecture file. In it is a diagram of the startup flow of the collector as well as links to key files / packages. I also added package level comments to some key packages.

I wrote some other documentation in #10029 but split the PRs up.

@ankitpatel96 ankitpatel96 marked this pull request as ready for review May 1, 2024 21:52
@ankitpatel96 ankitpatel96 requested a review from a team as a code owner May 1, 2024 21:52
Copy link

codecov bot commented May 1, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 91.87%. Comparing base (326ef7c) to head (b2f63fe).
Report is 79 commits behind head on main.

Current head b2f63fe differs from pull request most recent head e16f0fd

Please upload reports for the commit e16f0fd to get more accurate results.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #10068      +/-   ##
==========================================
+ Coverage   91.55%   91.87%   +0.31%     
==========================================
  Files         360      356       -4     
  Lines       16693    16865     +172     
==========================================
+ Hits        15284    15495     +211     
+ Misses       1073     1031      -42     
- Partials      336      339       +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@ankitpatel96 ankitpatel96 changed the title Internal Architecture Doc + Package level comments Documentation improvements - Internal Architecture Doc + Package level comments May 1, 2024
@mx-psi mx-psi added the Skip Changelog PRs that do not require a CHANGELOG.md entry label May 2, 2024
Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
codeboten pushed a commit that referenced this pull request May 2, 2024
#### Documentation
I wrote comments on a bunch of important functions that helped me
understand how the collector works.
I also created some other documentation in
#10068 -
but split it up from this PR.
@mx-psi mx-psi requested a review from bogdandrutu May 3, 2024 11:38
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
otelcol/collector.go Outdated Show resolved Hide resolved
otelcol/collector.go Outdated Show resolved Hide resolved
component/component.go Outdated Show resolved Hide resolved
ankitpatel96 and others added 2 commits May 8, 2024 15:27
Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
Copy link
Contributor

@evan-bradley evan-bradley left a comment

Choose a reason for hiding this comment

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

Thanks for adding this, it's great to have docs like these. Overall looks good to me.

docs/internal-architecture.md Outdated Show resolved Hide resolved
service/internal/graph/graph.go Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
Copy link
Member

@crobert-1 crobert-1 left a comment

Choose a reason for hiding this comment

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

Looks good, mostly just some minor nits 👍

docs/internal-architecture.md Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
otelcol/collector.go Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
otelcol/collector.go Outdated Show resolved Hide resolved
@mx-psi mx-psi requested a review from evan-bradley May 14, 2024 15:10
docs/internal-architecture.md Outdated Show resolved Hide resolved
docs/internal-architecture.md Outdated Show resolved Hide resolved
Copy link

linux-foundation-easycla bot commented May 20, 2024

CLA Signed

The committers listed above are authorized under a signed CLA.

@mx-psi mx-psi merged commit ecdbb53 into open-telemetry:main May 20, 2024
47 checks passed
@github-actions github-actions bot added this to the next release milestone May 20, 2024
andrzej-stencel pushed a commit to andrzej-stencel/opentelemetry-collector that referenced this pull request May 27, 2024
…y#10029)

#### Documentation
I wrote comments on a bunch of important functions that helped me
understand how the collector works.
I also created some other documentation in
open-telemetry#10068 -
but split it up from this PR.
andrzej-stencel pushed a commit to andrzej-stencel/opentelemetry-collector that referenced this pull request May 27, 2024
…l comments (open-telemetry#10068)

<!--Describe the documentation added.-->
#### Documentation
Creates an internal architecture file. In it is a diagram of the startup
flow of the collector as well as links to key files / packages. I also
added package level comments to some key packages.

I wrote some other documentation in
open-telemetry#10029 but
split the PRs up.

---------

Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Skip Changelog PRs that do not require a CHANGELOG.md entry
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants