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

Move example description to README frontmatter #3201

Merged
merged 3 commits into from
Sep 5, 2023

Conversation

abey79
Copy link
Member

@abey79 abey79 commented Sep 4, 2023

What

The description for the few examples included in demo.rerun.io and in the in-app example page was so far stored in scripts/ci/build_demo_app.py. This PR moves this information to these examples' respective README.md frontmatter. The build_demo_app.py is updated accordingly.

This description should be used for the in-app and web example pages, as well as for the help button in demo.rerun.io. For layout purposes, it is important that this description remains short. This PR introduces a lint to enforce a 130 character limit.

Note:

  • Updating all example descriptions is beyond the scope of this PR. Until that's done, the web example page should fallback to the current "truncated-README" approach.
  • The content from help button in demo.rerun.io become much smaller now, since the new description format has to be compact. This is acceptable as this will be sunsetted in favour of app.rerun.io + in-app example page (see app.rerun.io should default to a blank viewer with the Welcome Screen #3196)

Checklist

@abey79 abey79 added 🧑‍💻 dev experience developer experience (excluding CI) 🕸️ web regarding running the viewer in a browser labels Sep 4, 2023
@abey79
Copy link
Member Author

abey79 commented Sep 4, 2023

cc @martenbjork

abey79 added a commit that referenced this pull request Sep 4, 2023
@abey79 abey79 merged commit 160da26 into main Sep 5, 2023
26 checks passed
@abey79 abey79 deleted the antoine/description-in-frontmatter branch September 5, 2023 07:54
abey79 added a commit that referenced this pull request Sep 6, 2023
### What

Add Example page to the Welcome Screen.


Fixes #3096 

<img width="1366" alt="image"
src="https://github.com/rerun-io/rerun/assets/49431240/bbe2e84e-9ade-4da8-b095-d7b0f396c26f">

### TODO

- [x] fix layout issues
- [x] display tags
- [x] have dedicated, short copy for the description: #3201

### Not included in this PR

- **WARNING**: here, we bake in a manifest with hard-coded links to RRDs
that were generated within this PR. This will lead to issue down the
line, when the RRD format changes.
  - #3212
  - #3213
- download updated manifest
  -  #3190 
- load thumbnail from the web
  - emilk/egui#3291
- provide feedback while downloading a RRD
  - #3192

### Checklist
* [x] I have read and agree to [Contributor
Guide](https://github.com/rerun-io/rerun/blob/main/CONTRIBUTING.md) and
the [Code of
Conduct](https://github.com/rerun-io/rerun/blob/main/CODE_OF_CONDUCT.md)
* [x] I've included a screenshot or gif (if applicable)
* [x] I have tested [demo.rerun.io](https://demo.rerun.io/pr/3191) (if
applicable)

- [PR Build Summary](https://build.rerun.io/pr/3191)
- [Docs
preview](https://rerun.io/preview/3be107e4cc6aa6758a3f22c27a79233b33f2ea6b/docs)
<!--DOCS-PREVIEW-->
- [Examples
preview](https://rerun.io/preview/3be107e4cc6aa6758a3f22c27a79233b33f2ea6b/examples)
<!--EXAMPLES-PREVIEW-->
- [Recent benchmark results](https://ref.rerun.io/dev/bench/)
- [Wasm size tracking](https://ref.rerun.io/dev/sizes/)

---------

Co-authored-by: Emil Ernerfeldt <emil.ernerfeldt@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🧑‍💻 dev experience developer experience (excluding CI) 🕸️ web regarding running the viewer in a browser
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants