Skip to content

docs: Add develop-docs with Perfetto profiling documentation - #5750

Merged
markushi merged 5 commits into
mainfrom
feat/develop-docs
Aug 12, 2026
Merged

docs: Add develop-docs with Perfetto profiling documentation#5750
markushi merged 5 commits into
mainfrom
feat/develop-docs

Conversation

@markushi

@markushi markushi commented Jul 9, 2026

Copy link
Copy Markdown
Member

Summary

Introduces a develop-docs/ folder for internal developer documentation.

  • README.md — defines the documentation conventions: flat directory structure with filename prefixes (general-, feature-, integration-, platform-, process-), lowercase dash-separated names, same-named folders for embedded assets, present-tense/active-voice writing, and Mermaid for diagrams.
  • feature-perfetto-profiling.md — first feature doc, covering the Android Perfetto continuous-profiling pipeline end to end: capturing profile chunks via android.os.ProfilingManager, the meta_length envelope framing, Relay's Perfetto → Sample v2 conversion and object-store routing, and the monolith's storage, serving, and download endpoints.

#skip-changelog

🤖 Generated with Claude Code

markushi and others added 2 commits July 9, 2026 11:20
Introduce a develop-docs folder for internal developer documentation, with a
README defining the docs conventions (flat structure, prefixes, naming, images,
Mermaid) and a first feature doc covering the Android Perfetto profiling pipeline
from the SDK through Relay to the monolith.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sentry

sentry Bot commented Jul 9, 2026

Copy link
Copy Markdown

📲 Install Builds

Android

🔗 App Name App ID Version Configuration
SDK Size io.sentry.tests.size 8.52.0 (1) release

⚙️ sentry-android Build Distribution Settings

@runningcode runningcode left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good to me! I only reviewed the README.md in detail.

Comment thread develop-docs/README.md Outdated
Comment thread develop-docs/README.md Outdated
Comment thread develop-docs/feature-perfetto-profiling.md Outdated
Comment thread develop-docs/README.md
@markushi
markushi marked this pull request as ready for review July 21, 2026 14:23

@0xadam-brown 0xadam-brown left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks for this @markushi 💯 !

A few comments for your consideration; no blockers.

Comment thread develop-docs/feature-perfetto-profiling.md Outdated
Comment thread develop-docs/feature/profiling/perfetto.md
Comment thread develop-docs/README.md Outdated
Comment thread develop-docs/README.md Outdated
markushi and others added 2 commits August 12, 2026 10:38
… review feedback

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Replaces the flat filename-prefix convention with a directory tree, per PR review feedback.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@markushi
markushi merged commit 4d15f0e into main Aug 12, 2026
74 of 75 checks passed
@markushi
markushi deleted the feat/develop-docs branch August 12, 2026 11:13
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.

3 participants