[Docs] ES UI form library

[sebelga]

This PR adds the documentation for the form lib.

Meanwhile I wait for the instruction from @snide for the new documentation website these are the steps to launch the current docs locally and be able to review them

• yarn kbn bootstrap
• cd src/plugins/es_ui_shared/docs && yarn
• From the root of the repo yarn docs
• Access the form lib docs at http://localhost:3000/docs/form_lib/getting_started/about

Note: Only review the documentation of the form lib as all the rest will be discarted in favor of the new docs website.

[cjcenizal]

Thanks for putting so much effort into this, Seb! These docs have already helped me gain a much better understanding of the form lib than I previously had. I'm still working my way through the docs though, page by page, but I have a number of comments, suggestions, and questions so far.

[cjcenizal]

I just finished Core > Getting Started and wanted to share my feedback so far with you, since I will need to pause my review and shift focus to something else for the day.

[alisonelizabeth]

These docs are looking awesome @sebelga! Great work. I've left a few comments of what I've reviewed so far (mostly typo fixes). I'll continue reviewing later today and tomorrow.

[alisonelizabeth]

I finished reading through the docs! 🎉 I left a few more comments/suggestions.

[jloleysens]

Great work @sebelga !

I left comments for improvements, but don't feel you need to block on them - I like CJ's points about simplifying/clarifying some of the examples and gave one suggestion of linking to the existing "default values" documentation that I think would be nice to add.

One other comment I made was about setting of "defaultValues" and that this is something we don't want users of the library to misuse. I'd like to get your thoughts on that as perhaps you have a different view regarding that API capability.

Cheers 🍻

[elasticmachine]

Pinging @elastic/es-ui (Team:Elasticsearch UI)

[cjcenizal]

Thanks for going through all of my feedback! I will take another pass once we are using the new docs system. Great work driving this forward, Seb. 👏

[sebelga]

Thanks for the great feedback @alisonelizabeth @cjcenizal and @jloleysens ! I addressed most of your comments and committed your suggested changes. I will now close this PR and start integrating the docs in the new doc system.

[kibanamachine]

💔 Build Failed

• continuous-integration/kibana-ci/pull-request
• Commit: 422479b
• Pipeline Steps (look for red circles / failed steps)
• Interpreting CI Failures

Failed CI Steps

• Setup Build Environment and Dependencies
• Setup Build Environment and Dependencies
• Setup Build Environment and Dependencies
• Setup Build Environment and Dependencies

Metrics [docs]

‼️ ERROR: metrics for 422479b were not reported

History

• 💔 Build #107638 failed 229947d
• 💔 Build #82682 failed 869267e
• 💔 Build #80052 failed 27c31ac
• 💔 Build #79672 failed f63c2e7

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream