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

PR: Improvements on Existing Field Articles #318

Merged
merged 3 commits into from
Nov 28, 2024
Merged

PR: Improvements on Existing Field Articles #318

merged 3 commits into from
Nov 28, 2024

Conversation

bbrennanbasis
Copy link
Contributor

Description

This PR focuses on improving currently existing documentation for field components. Issue #166 is ignored for this PR because it involves creating new content/articles.

Changes

  • Grammar corrections
  • Added parentheses behind every method name
  • Corrected ComponentDemo URLs
  • Gave a more assertive tone in Best practices sections
  • Addressed Valve errors
  • Removed extra import statements
  • Removed commented-out sections
  • Reorganized the TOC order to reflect the Components Overview page
  • Significantly rewrote the following sections:
    • ColorField: Color code format
    • PasswordField: Password visibility
    • PasswordField: Best practices (Password Confirmation)

Note

Any corrections and additions needed for the Styling sections are addressed in PR #296.

This commit focused on improving the current documentation for field components:
- Added parentheses behind every method name
- Corrected ComponentDemo URLs
- Gave a more assertive tone in **Best practices**
- Addressed Valve errors
- Removed extra import statements
- Removed commented-out sections
- Reorganized the TOC order to reflect the Components Overview page
- Significant rewrote the following sections:
  - **ColorField Color code format**
  - **PasswordField Password visibility**
  - **PasswordField Best practices (Password Confirmation)**
docs/components/fields/time-field.md Show resolved Hide resolved

The `TimeField` will, by default, display its information within the UI element based on the locale the browser is configured to. For example, users with United States configurations will see the time displayed with A.M. and P.M. labels, whereas other locales would see the time in 24 hour format. This does not inhibit manipulation of the `LocalTime` object returned by methods from the class, however.
The value of the time field is always in 24-hour format that includes leading zeros: HH:mm, regardless of the UI field format, which is likely to be selected based on the user's locale (or by the user agent). If the time includes seconds, the format is always HH:mm:ss
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[Google.Parens] Use parentheses judiciously.

<JavadocLink type="foundation" location="com/webforj/component/field/PasswordField" top='true'/>

<ParentLink parent="Field" />

The `PasswordField` component provides a way for the user to securely enter a password. The element is presented as a one-line plain text editor control in which the text is obscured so that it cannot be read, usually by replacing each character with a symbol such as the asterisk ("*") or a dot ("•"). This character will vary depending on the user agent and operating system.
The `PasswordField` component empowers users to enter their passwords confidently, ensuring security and privacy. It elegantly presents itself as a single-line text editor, where each character transforms into an obscured symbol, usually an asterisk ("*") or a dot ("•"), depending on the user agent and operating system.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[Google.Parens] Use parentheses judiciously.

@hyyan
Copy link
Member

hyyan commented Nov 28, 2024

@bbrennanbasis I will merge this as it is for now, as there are numerous reported issues related to each field article. Please start reviewing them one by one and submit a pull request for each. Don’t hesitate to reach out if you need any help.

@hyyan hyyan merged commit 14f72b8 into website Nov 28, 2024
1 check failed
@hyyan hyyan deleted the fields-docs branch November 28, 2024 11:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

2 participants