hedera-docs icon indicating copy to clipboard operation
hedera-docs copied to clipboard

Update SDK Create Account Page

Open Reccetech opened this issue 4 months ago • 0 comments

This is the proposed SDK Create an Account page to replace the content [here](https://docs.hedera.com/hedera/sdks-and-apis/sdks/accounts-and-hbar/create-an-account) This page was written with support by AI (chatGPT5) for AI consumption. The major changes in this page include:

  • Standardized method names and explanations so AI models can more reliably map user intent (“EVM Address derived from public key” vs “EVM Address Alias”), reducing ambiguity in semantic parsing.
  • Consolidated alias terminology into explicit phrases rather than shorthand, which helps AI correctly distinguish between key-based aliases and account-ID-based long zero aliases without needing external context.
  • Added a dedicated helpers section that explicitly enumerates method behaviors (.setECDSAKeyWithAlias, .setKeyWithAlias, .setKeyWithoutAlias, .toEvmAddress). This removes implicit assumptions and provides structured, declarative statements that AI can retrieve directly.
  • Converted explanatory notes into consistent subject → verb → object patterns (e.g., “Returns the initial balance that will be transferred to the new account”) to improve machine readability.
  • Reorganized Get Transaction Values into a compact table with uniform phrasing. This eliminates scattered examples and ensures AI can extract API capability descriptions without parsing narrative code blocks.
  • Made code samples uniform across languages (JS, Java, Rust) with the same structure, logging style, and output labeling. These code samples are directly from the Hedera Portal. AI can now align code concepts across SDKs more easily when answering multilingual developer questions.
  • Introduced consistent output printing (Account ID, Alias, Initial Balance) across all examples. This consistency improves AI’s ability to recognize patterns and provide comparable answers regardless of programming language.
  • Simplified Common pitfalls into concise, declarative statements with direct references to possible errors (e.g., INVALID_ALIAS, BUSY). This improves precision in AI troubleshooting by reducing vague or verbose phrasing.
  • Replaced generic “See Also” with an in-line authoritative link (transaction throttling docs). This gives AI a clear reference point instead of relying on unspecific cross-links.

The proposed content is attached.

CreateAnAccount.md

Reccetech avatar Sep 16 '25 22:09 Reccetech