Hi Bricks team,
I’d like to kindly ask for a complete review and update of the developer documentation, because right now many parts are outdated and it’s causing a significant waste of time during development.
A feature that would help a lot would be a version switcher in the docs, so developers can easily view documentation based on the Bricks version they are working with.
For example, in the documentation page about the bricks/form/validate filter:
https://academy.bricksbuilder.io/developer/hooks/filters/bricks-form-validate/
the example still references the get_element_id() function, but that function no longer exists. This makes the example unusable and confusing.
DEBUG Class: Bricks\Integrations\Form\Init
DEBUG Methods: __construct, form_submit, set_result, get_settings, get_fields, get_id, get_post_id, get_uploaded_files, get_results, extensions_to_mime_types, handle_files, handle_uploaded_files, remove_files, render_data, get_field_value, get_file_field_property, get_available_actions, set_error_messages, validate_required_fields, get_submission_url_param, get_acf_field_key_from_meta_key, get_meta_box_field_key_from_meta_key
And this is only one example. Yesterday I also found outdated information in the “Create Your Own Element” guide.
I really appreciate the work behind Bricks, but accurate documentation is critical for developers. Otherwise the documentation loses a big part of its value because we cannot reliably trust the examples anymore.
Thanks.