api docs are anemic

[Hadakajime]

API docs are missing a lot of information.

For example, there is no comprehensive reference for valid properties passed to textBox() for use in selection, such as {placeholder: "enter text"}

https://docs.taiko.dev/api/textbox/

and I can't find any reference via the searchbox for .value()

also, your api list is not sorted alphabetically:

https://docs.taiko.dev/api/reference/

[zabil]

Thanks for the feedback.

{placeholder: "enter text"} is implied at https://docs.taiko.dev/api/textbox/ under labelOrAttrValuePairs as placeholder is an attribute. Please feel free to send a PR if you feel it's best explained in the example.

.value() is a bit confusing bit it's there if you follow https://docs.taiko.dev/api/textboxwrapper/ https://docs.taiko.dev/api/valuewrapper/ again an example could make it easier.

You can add examples here

taiko/lib/taiko.js

Lines 1789 to 1805 in 329f1a4

	* This {@link selector} lets you identify a text field(input (with type text, password, url, search, number, email, tel), textarea and contenteditable fields)
	* on a web page either with label or with attribute and value pairs and proximity selectors.
	*
	* @example
	* await focus(textBox('Username:'))
	* @example
	* await textBox('Username:').exists()
	* @example
	* await textBox({id:'textBoxId'},below('text')).exists()
	* @example
	* await textBox(below('text')).exists()
	*
	* @param {Object} labelOrAttrValuePairs - Either the label (human-visible name) of the text field or pairs of attribute and value like {"id":"name","class":"class-name"}
	* @param {Object} _options
	* @param {...relativeSelector} args - Proximity selectors
	* @returns {TextBoxWrapper}
	*/