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

Add "rerun_example_" prefix to all our user-visible app-ids #3112

Merged
merged 6 commits into from Aug 29, 2023

Conversation

emilk
Copy link
Member

@emilk emilk commented Aug 25, 2023

What

The exact prefix is not super important. Once there, we can search-replace easily.

I also added the app_id_starts_with_rerun_example analytics signal for this (needed since we hash the app id).
The old is_official_example is still there (its not implemented for C++ though).

Review commit-by-commit

Checklist

@emilk emilk added 📖 documentation Improvements or additions to documentation examples Issues relating to the Rerun examples labels Aug 25, 2023
Copy link
Member

@nikolausWest nikolausWest left a comment

Choose a reason for hiding this comment

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

I think we need to decide on how to format the recording id strings and then do it the same everywhere. This looks way too sloppy as one of the first touch points a user gets of Rerun.

I prefer "Rerun example: annotation context rects" but we could also go with "rerun-example-annotation-context-rects" or "rerun_example_annotation_context_rect", as long as we're consistent.

@@ -9,7 +9,7 @@
image[130:180, 100:280] = 45000


rr.init("depth_image", spawn=True)
rr.init("rerun-example-depth_image", spawn=True)
Copy link
Member

Choose a reason for hiding this comment

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

I think all these actually look quite ugly. I'd honestly prefer if we just used regular whitespace for all the recording id's. What's even the reason for using snake or kebab case?

Copy link
Member

Choose a reason for hiding this comment

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

With "these" I'm particularly referring to the snake_-kebab

Copy link
Member Author

@emilk emilk Aug 28, 2023

Choose a reason for hiding this comment

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

The reason is that this is an id, not a name or title.

A user reading "Rerun example: annotation context rects" is likely to interpret that string as a title, and would probably be surprised that changing it slightly would have side-effects, like Rerun no longer associating a previously stored blueprint with the new recording.

@emilk
Copy link
Member Author

emilk commented Aug 28, 2023

I switched all app-ids to snake_case now

@emilk emilk changed the title Add "rerun-example-" prefix to all our user-visible app-ids Add "rerun_example_" prefix to all our user-visible app-ids Aug 28, 2023
Copy link
Member

@nikolausWest nikolausWest left a comment

Choose a reason for hiding this comment

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

👍

@emilk emilk added this to the 0.8.2 milestone Aug 29, 2023
@github-actions
Copy link

Size changes

Name Previous Current Change
Wasm (none) 14.37 MiB +100%
JS (none) 109.6 kiB +100%
arkit_scenes.rrd (none) 40.41 MiB +100%
detect_and_track_objects.rrd (none) 55.22 MiB +100%
dicom_mri.rrd (none) 63.35 MiB +100%
dna.rrd (none) 0.62 MiB +100%
human_pose_tracking.rrd (none) 55.6 MiB +100%
plots.rrd (none) 0.19 MiB +100%
structure_from_motion.rrd (none) 6.83 MiB +100%

@emilk emilk merged commit b55e818 into main Aug 29, 2023
26 checks passed
@emilk emilk deleted the emilk/better-example-detection branch August 29, 2023 07:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📖 documentation Improvements or additions to documentation examples Issues relating to the Rerun examples
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Better example/tutorial detection for analytics
3 participants