From fa175b94f9297b08f467b4e9646454d074bc8bd7 Mon Sep 17 00:00:00 2001
From: Amira Nasri <nasriamira88@gmail.com>
Date: Wed, 11 Dec 2024 15:15:51 +0100
Subject: [PATCH] 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 <gagdiez.c@gmail.com>
---
 docs/2.build/2.smart-contracts/quickstart.md | 25 ++++++++++++--------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/docs/2.build/2.smart-contracts/quickstart.md b/docs/2.build/2.smart-contracts/quickstart.md
index d6ca139d4f..a1c0d8e7b0 100644
--- 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>