Add comments and inline docs for visualization saving and editing process. by cjcenizal · Pull Request #8208 · elastic/kibana

cjcenizal · 2016-09-09T20:25:57Z

Supersedes #7968

The goal is to clarify where URL state is coming from, when working with visualizations. Some of the classes touched upon are: SavedVis, PersistedState, AppState, and base classes.

Explored files:

src/core_plugins/kibana/public/visualize/editor/editor.js
src/core_plugins/kibana/public/visualize/saved_visualizations/_saved_vis.js
src/ui/public/courier/data_source/_doc_send_to_es.js
src/ui/public/courier/data_source/doc_source.js
src/ui/public/courier/saved_object/saved_object.js
src/ui/public/es.js
src/ui/public/events.js
src/ui/public/persisted_state/persisted_state.js
src/ui/public/state_management/app_state.js
src/ui/public/state_management/state.js
src/ui/public/vis/agg_config.js
src/ui/public/vis/agg_configs.js
src/ui/public/vis/vis.js

epixa · 2016-10-08T15:48:14Z

@cjcenizal What's the status of this?

cjcenizal · 2016-10-10T22:45:20Z

@epixa I'll get this merged this week.

tylersmalley

Just found one nitpick, but other than that it was a very informative PR.

tylersmalley · 2016-10-10T23:46:14Z

src/ui/public/es.js

To keep this PR consistent, can we place a line break between name and description?

thomasneirynck · 2016-10-10T23:59:34Z

LGTM

spalger

Some of the descriptions here feel more like observations, and not descriptions of the functionality they label. I'm all for sharing your observations but I would rather only put full-formed descriptions into the code.

spalger · 2016-10-11T00:19:53Z

src/core_plugins/kibana/public/visualize/editor/editor.js

Is this not explained above?

When a vis is marked as being requested, the bounds of that vis are updated and new data is fetched using the new bounds.

You actually made this comment on the original PR: #7968 (comment)

spalger · 2016-10-11T00:20:26Z

src/core_plugins/kibana/public/visualize/editor/editor.js

I think that in order for this to be useful the comment should point to the actual file, not just vis.js

spalger · 2016-10-11T00:21:17Z

src/core_plugins/kibana/public/visualize/editor/editor.js

I think this should probably point the reader to where they can find the current state (like the URL) rather than list out it's properties. Otherwise the list will just get out of date and not benefit anyone

Sounds good but not sure what you mean re point out where the reader can find current state. Can you give me an example of the comment you have in mind?

spalger · 2016-10-11T00:24:06Z

src/ui/public/courier/data_source/_doc_send_to_es.js

I don't think this comment is useful

It's not the most insightful comment, but it does give some idea of the relationship with the other actors in our codebase, so I'd like to leave it unless we can come up with a more meaningful description. :)

spalger · 2016-10-11T00:27:45Z

src/ui/public/courier/data_source/doc_source.js

The relationship between this class and _doc_send_to_es doesn't really describe the class at all

I think you'll need to illuminate me...

spalger · 2016-10-11T00:39:07Z

src/ui/public/es.js

esFactory is exposed by the elasticsearch.angular.js client

spalger · 2016-10-11T00:40:06Z

src/ui/public/vis/vis.js

party pooper

spalger · 2016-10-11T00:44:24Z

src/core_plugins/kibana/public/visualize/editor/editor.js

I don't see how the change or fetch_with_changes listeners are of any importance here. All that maters is that the properties of the appState are synced with the url, right? In order to save changes call appState.save() any changed from the url will be reflected in the properties of the appState

spalger · 2016-10-11T00:46:29Z

src/core_plugins/kibana/public/visualize/editor/editor.js

This is probably unnecessary

I would agree if the name of the method was something like onClickSave to indicate that this is part of the interface exposed to the template. But since the role of this method is a little unclear from the name, I'd like to leave this comment until we refactor and clarify naming.

spalger · 2016-10-11T00:47:02Z

src/core_plugins/kibana/public/visualize/saved_visualizations/_saved_vis.js

Not seeing the value in this description

cjcenizal · 2016-10-11T18:41:26Z

jenkins, test this

…cess. The goal is to clarify where URL state is coming from, when working with visualizations. Some of the classes touched upon are: SavedVis, PersistedState, AppState, and base classes. Explored files: - src/core_plugins/kibana/public/visualize/editor/editor.js - src/core_plugins/kibana/public/visualize/saved_visualizations/_saved_vis.js - src/ui/public/courier/data_source/_doc_send_to_es.js - src/ui/public/courier/data_source/doc_source.js - src/ui/public/courier/saved_object/saved_object.js - src/ui/public/es.js - src/ui/public/events.js - src/ui/public/persisted_state/persisted_state.js - src/ui/public/state_management/app_state.js - src/ui/public/state_management/state.js - src/ui/public/vis/agg_config.js - src/ui/public/vis/agg_configs.js - src/ui/public/vis/vis.js

epixa · 2016-10-11T19:39:27Z

@cjcenizal To help in our ongoing quest to make backports easier, please backport this to 5.x and 5.0

--------- **Commit 1:** Add comments and inline docs for visualization saving and editing process. The goal is to clarify where URL state is coming from, when working with visualizations. Some of the classes touched upon are: SavedVis, PersistedState, AppState, and base classes. Explored files: - src/core_plugins/kibana/public/visualize/editor/editor.js - src/core_plugins/kibana/public/visualize/saved_visualizations/_saved_vis.js - src/ui/public/courier/data_source/_doc_send_to_es.js - src/ui/public/courier/data_source/doc_source.js - src/ui/public/courier/saved_object/saved_object.js - src/ui/public/es.js - src/ui/public/events.js - src/ui/public/persisted_state/persisted_state.js - src/ui/public/state_management/app_state.js - src/ui/public/state_management/state.js - src/ui/public/vis/agg_config.js - src/ui/public/vis/agg_configs.js - src/ui/public/vis/vis.js * Original sha: 34e3f49 * Authored by CJ Cenizal <cj@cenizal.com> on 2016-08-10T00:10:48Z

[backport] PR #8208 to 5.0

[backport] PR #8208 to 5.x - Add comments and inline docs for visualization saving and editing process.

cjcenizal · 2016-10-11T19:43:19Z

Backported to 5.0 and 5.x.

--------- **Commit 1:** Add comments and inline docs for visualization saving and editing process. The goal is to clarify where URL state is coming from, when working with visualizations. Some of the classes touched upon are: SavedVis, PersistedState, AppState, and base classes. Explored files: - src/core_plugins/kibana/public/visualize/editor/editor.js - src/core_plugins/kibana/public/visualize/saved_visualizations/_saved_vis.js - src/ui/public/courier/data_source/_doc_send_to_es.js - src/ui/public/courier/data_source/doc_source.js - src/ui/public/courier/saved_object/saved_object.js - src/ui/public/es.js - src/ui/public/events.js - src/ui/public/persisted_state/persisted_state.js - src/ui/public/state_management/app_state.js - src/ui/public/state_management/state.js - src/ui/public/vis/agg_config.js - src/ui/public/vis/agg_configs.js - src/ui/public/vis/vis.js * Original sha: 3cf76b6004f98d694cb0d31831035e806f71357c [formerly 34e3f49] * Authored by CJ Cenizal <cj@cenizal.com> on 2016-08-10T00:10:48Z Former-commit-id: 433c265

[backport] PR elastic#8208 to 5.x - Add comments and inline docs for visualization saving and editing process. Former-commit-id: 8752eea

`99.0.0-borealis.1` ⏩ `99.1.0-borealis.0` [Questions? Please see our Kibana upgrade FAQ.](https://github.com/elastic/eui/blob/main/wiki/eui-team-processes/upgrading-kibana.md#faq-for-kibana-teams) --- # `@elastic/eui` ## [`v99.1.0`](https://github.com/elastic/eui/releases/v99.1.0) - Updated `EuiColorPalettePicker` - adds `append` to `EuiColorPalettePickerPaletteProps` to support appending custom content to the title ([#8208](elastic/eui#8208)) - Updated font-weight and font-size of `EuiBetaBadge`s to improve legibility ([#8255](elastic/eui#8255)) - Added suppport for `titleColor` variant `warning` on `EuiStat` ([#8278](elastic/eui#8278)) # `@elastic/eui-theme-borealis` ## `v0.0.9` - [Visual Refresh] Support new theme tokens on JSON exports ([#8277](elastic/eui#8277)) - Remap few colors for EuiLoadingSpinner and EuiLoadingChart ([#8276](elastic/eui#8276)) - [Visual Refresh] Update floating border on EuiPanel ([#8270](elastic/eui#8270)) --------- Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> Co-authored-by: nickofthyme <nicholas.partridge@elastic.co> Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>

`98.2.2-borealis.0` ⏩ `99.3.0-classic.0` [Questions? Please see our Kibana upgrade FAQ.](https://github.com/elastic/eui/blob/main/wiki/eui-team-processes/upgrading-kibana.md#faq-for-kibana-teams) --- ## [`v99.3.0`](https://github.com/elastic/eui/releases/v99.3.0) - Updated table components to support adding tooltips to header cells ([#8273](elastic/eui#8273)) - Added `columns.nameTooltip` on `EuiBasicTable` - Added `tooltipProps` prop on `EuiTableHeaderCell` - Added `accent` color option to `EuiCallOut` ([#8303](elastic/eui#8303)) - Updated `EuiInlineEditForm`'s `onCancel` prop type to allow uncontrolled mode usage ([#8307](elastic/eui#8307)) - Added ES|QL syntax highlighting for `EuiCode`, `EuiCodeBlock`, `EuiMarkdownFormat`, and `EuiMarkdownEditor` components. ([#8317](elastic/eui#8317)) - Updated `EuiAccordion` to prevent content from being transitioned on initial render when `initialIsOpen=true` ([#8327](elastic/eui#8327)) **Bug fixes** - Fixed a bug on `EuiSuperDatePicker` where pasting an absolute date would append the date instead of replace it ([#8311](elastic/eui#8311)) ## [`v99.2.0`](https://github.com/elastic/eui/releases/v99.2.0) - Changed `EuiFieldText` styles to prioritize `disabled` styling over `readonly`. ([#8271](elastic/eui#8271)) - Added `plugs` and `web` glyphs to `EuiIcon` ([#8285](elastic/eui#8285)) - Update `title` on `EuiColorPalettePickerPaletteProps` to be optional ([#8289](elastic/eui#8289)) **Bug fixes** - Fixed an issue with EuiDataGrid with auto row height resulting in a table of 0 height ([#8251](elastic/eui#8251)) - Fixed `disabled` behavior of `EuiFieldText` to prevent input changes. ([#8271](elastic/eui#8271)) ## [`v99.1.0`](https://github.com/elastic/eui/releases/v99.1.0) - Updated `EuiColorPalettePicker` - adds `append` to `EuiColorPalettePickerPaletteProps` to support appending custom content to the title ([#8208](elastic/eui#8208)) - Updated font-weight and font-size of `EuiBetaBadge`s to improve legibility ([#8255](elastic/eui#8255)) - Added support for `titleColor` variant `warning` on `EuiStat` ([#8278](elastic/eui#8278)) ## [`v99.0.0`](https://github.com/elastic/eui/releases/v99.0.0) - Added two new icons: `createGenericJob` and `createGeoJob` ([#8248](elastic/eui#8248)) - Added new icon `section` ([#8261](elastic/eui#8261)) **Bug fixes** - Ensures that the `values` of `EuiI18n` used in `EuiPagination` use `key` attributes to prevent potential ["unique key" warnings](https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key). ([#8243](elastic/eui#8243)) **Breaking changes** - Removed `EuiPopover`'s deprecated `hasDragDrop` prop. Use `usePortal` on any child `EuiDraggable` instead ([#8256](elastic/eui#8256)) --------- Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> Co-authored-by: Arturo Castillo Delgado <arturo.castillo@elastic.co> Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com> Co-authored-by: Lene Gadewoll <lene.gadewoll@elastic.co>

`98.2.2-borealis.0` ⏩ `99.3.0-classic.0` [Questions? Please see our Kibana upgrade FAQ.](https://github.com/elastic/eui/blob/main/wiki/eui-team-processes/upgrading-kibana.md#faq-for-kibana-teams) --- ## [`v99.3.0`](https://github.com/elastic/eui/releases/v99.3.0) - Updated table components to support adding tooltips to header cells ([elastic#8273](elastic/eui#8273)) - Added `columns.nameTooltip` on `EuiBasicTable` - Added `tooltipProps` prop on `EuiTableHeaderCell` - Added `accent` color option to `EuiCallOut` ([elastic#8303](elastic/eui#8303)) - Updated `EuiInlineEditForm`'s `onCancel` prop type to allow uncontrolled mode usage ([elastic#8307](elastic/eui#8307)) - Added ES|QL syntax highlighting for `EuiCode`, `EuiCodeBlock`, `EuiMarkdownFormat`, and `EuiMarkdownEditor` components. ([elastic#8317](elastic/eui#8317)) - Updated `EuiAccordion` to prevent content from being transitioned on initial render when `initialIsOpen=true` ([elastic#8327](elastic/eui#8327)) **Bug fixes** - Fixed a bug on `EuiSuperDatePicker` where pasting an absolute date would append the date instead of replace it ([elastic#8311](elastic/eui#8311)) ## [`v99.2.0`](https://github.com/elastic/eui/releases/v99.2.0) - Changed `EuiFieldText` styles to prioritize `disabled` styling over `readonly`. ([elastic#8271](elastic/eui#8271)) - Added `plugs` and `web` glyphs to `EuiIcon` ([elastic#8285](elastic/eui#8285)) - Update `title` on `EuiColorPalettePickerPaletteProps` to be optional ([elastic#8289](elastic/eui#8289)) **Bug fixes** - Fixed an issue with EuiDataGrid with auto row height resulting in a table of 0 height ([elastic#8251](elastic/eui#8251)) - Fixed `disabled` behavior of `EuiFieldText` to prevent input changes. ([elastic#8271](elastic/eui#8271)) ## [`v99.1.0`](https://github.com/elastic/eui/releases/v99.1.0) - Updated `EuiColorPalettePicker` - adds `append` to `EuiColorPalettePickerPaletteProps` to support appending custom content to the title ([elastic#8208](elastic/eui#8208)) - Updated font-weight and font-size of `EuiBetaBadge`s to improve legibility ([elastic#8255](elastic/eui#8255)) - Added support for `titleColor` variant `warning` on `EuiStat` ([elastic#8278](elastic/eui#8278)) ## [`v99.0.0`](https://github.com/elastic/eui/releases/v99.0.0) - Added two new icons: `createGenericJob` and `createGeoJob` ([elastic#8248](elastic/eui#8248)) - Added new icon `section` ([elastic#8261](elastic/eui#8261)) **Bug fixes** - Ensures that the `values` of `EuiI18n` used in `EuiPagination` use `key` attributes to prevent potential ["unique key" warnings](https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key). ([elastic#8243](elastic/eui#8243)) **Breaking changes** - Removed `EuiPopover`'s deprecated `hasDragDrop` prop. Use `usePortal` on any child `EuiDraggable` instead ([elastic#8256](elastic/eui#8256)) --------- Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> Co-authored-by: Arturo Castillo Delgado <arturo.castillo@elastic.co> Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com> Co-authored-by: Lene Gadewoll <lene.gadewoll@elastic.co>

cjcenizal added review v6.0.0 labels Oct 10, 2016

cjcenizal assigned spalger Oct 10, 2016

cjcenizal force-pushed the improvement/document-url-state-files branch 2 times, most recently from b7285f5 to fcd9615 Compare October 10, 2016 23:47

tylersmalley approved these changes Oct 10, 2016

View reviewed changes

cjcenizal force-pushed the improvement/document-url-state-files branch from fcd9615 to b94253a Compare October 10, 2016 23:50

thomasneirynck self-assigned this Oct 10, 2016

spalger suggested changes Oct 11, 2016

View reviewed changes

cjcenizal force-pushed the improvement/document-url-state-files branch 2 times, most recently from f191358 to bd21af2 Compare October 11, 2016 18:04

spalger approved these changes Oct 11, 2016

View reviewed changes

cjcenizal force-pushed the improvement/document-url-state-files branch from bd21af2 to 00f532e Compare October 11, 2016 18:21

cjcenizal force-pushed the improvement/document-url-state-files branch from 00f532e to 34e3f49 Compare October 11, 2016 19:10

cjcenizal merged commit 4c45c26 into elastic:master Oct 11, 2016

cjcenizal deleted the improvement/document-url-state-files branch October 11, 2016 19:11

cjcenizal removed the review label Oct 11, 2016

elastic-jasper mentioned this pull request Oct 11, 2016

[backport] PR #8208 to 5.0 - Add comments and inline docs for visualization saving and editing process. #8624

Merged

elastic-jasper mentioned this pull request Oct 11, 2016

[backport] PR #8208 to 5.x - Add comments and inline docs for visualization saving and editing process. #8625

Merged

cjcenizal added a commit that referenced this pull request Oct 11, 2016

Merge pull request #8624 from elastic/jasper/backport/8208/5.0

772889f

[backport] PR #8208 to 5.0

cjcenizal added a commit that referenced this pull request Oct 11, 2016

Merge pull request #8625 from elastic/jasper/backport/8208/5.x

8752eea

[backport] PR #8208 to 5.x - Add comments and inline docs for visualization saving and editing process.

jimgoodwin added the v6.0.0-rc1 label Sep 28, 2017

Conversation

cjcenizal commented Sep 9, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

epixa commented Oct 8, 2016

Uh oh!

cjcenizal commented Oct 10, 2016

Uh oh!

tylersmalley left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

thomasneirynck commented Oct 10, 2016

Uh oh!

spalger left a comment

Choose a reason for hiding this comment

Uh oh!

spalger Oct 11, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

spalger Oct 11, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

spalger Oct 11, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

spalger Oct 11, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

spalger Oct 11, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

spalger Oct 11, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cjcenizal commented Oct 11, 2016

Uh oh!

epixa commented Oct 11, 2016

Uh oh!

cjcenizal commented Oct 11, 2016

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

cjcenizal commented Sep 9, 2016 •

edited

Loading

spalger Oct 11, 2016 •

edited

Loading

spalger Oct 11, 2016 •

edited

Loading

spalger Oct 11, 2016 •

edited

Loading

spalger Oct 11, 2016 •

edited

Loading

spalger Oct 11, 2016 •

edited

Loading

spalger Oct 11, 2016 •

edited

Loading