Testnet account warning admonition (#2361)

* update build command with no docker flag * add no docker flag to build command * add warning to test account creation * Apply suggestions from code review --------- Co-authored-by: Guille <[email protected]>
near · Dec 11, 2024 · fa175b9 · fa175b9
1 parent daf6bca
commit fa175b9
Showing 1 changed file with 15 additions and 10 deletions.
diff --git a/docs/2.build/2.smart-contracts/quickstart.md b/docs/2.build/2.smart-contracts/quickstart.md
@@ -258,22 +258,25 @@ Remember that you can create a named account through any wallet (i.e. [MyNearWal
 
 :::
 
+:::warning
+
+When running the near account create-account command in a headless Linux environment (e.g., WSL), the `save-to-keychain` option may fail due to platform limitations. Use `save-to-legacy-keychain` instead of `save-to-keychain` to ensure compatibility.
+
+:::
+
+
 ---
 
 ## Build the Contract
 
-If you encounter issues with Docker or prefer not to use Docker for building contracts, you can pass the --no-docker flag to certain commands (where applicable). 
+When you are ready to create a build of the contract run a one-line command depending on your environment.
+
 <Tabs groupId="cli-tabs">
   <TabItem value="js" label="🌐 JavaScript">
 
   ```bash
   npm run build
   ```
-  Or
-
-  ```bash
-  npm run build --no-docker
-  ```
 
   </TabItem>
 
@@ -282,11 +285,13 @@ If you encounter issues with Docker or prefer not to use Docker for building con
   ```bash
   cargo near build
   ```
-  Or
+
 
-  ```bash
-  cargo near build --no-docker
-  ```
+  :::info
+
+  If you encounter issues with Docker you can use the `--no-docker` flag to skip creating a reproducible build
+
+  :::
 
   </TabItem>