Skip to content

Commit eca9a55

Browse files
committed
docs: Update intro
1 parent 8bf8737 commit eca9a55

File tree

2 files changed

+23
-16
lines changed

2 files changed

+23
-16
lines changed

docs/content/Getting-Started/Introduction/_index.en.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,14 +14,20 @@ tools like [Roswell][] and [Qlot][], which only serve specific goals.
1414

1515
## ❓ Why Qob?
1616

17-
Qob is an Common Lisp project management tool, similar to Maven or Leiningen.
18-
It aims to control and automate the entire life cycle of an Common Lisp system,
19-
including dependency management, packaging, distribution and testing.
20-
21-
- Ruby projects have a `gemspec` file?
22-
- Node.js projects have a `package.json` file?
23-
- Clojure projects have a `project.clj` file?
24-
- Common Lisp projects have a `Qob` file?
17+
For many newcomers, getting started with Common Lisp can feel relatively
18+
easy compared to other advanced languages like Python or Rust.
19+
However, it is also perceived as a challenging language to begin with.
20+
This difficulty doesn't stem from the language itself but rather from the
21+
ecosystem: the environment, toolchain, sparse documentation, limited search
22+
results, and other complexities can create obstacles.
23+
24+
Qob aims to address these challenges by making the environment more accessible.
25+
It simplifies tasks such as building executables and determining which functions
26+
to call for specific commands. Qob allows users to perform various Lisp
27+
operations without directly interacting with a Lisp implementation (e.g., SBCL).
28+
By using Qob, you can enjoy a user experience closer to that of modern
29+
high-level programming languages, avoiding the reliance on the traditional
30+
`eval`-based workflows.
2531

2632
## 📰 News
2733

docs/content/Getting-Started/Introduction/_index.zh-tw.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,14 +14,15 @@ Qob 嘗試在這些事情上做得很好:
1414

1515
## ❓ 為什麼選擇 Qob?
1616

17-
Qob 是一個 Common Lisp 專案管理工具,類似於 Maven 或 Leiningen。
18-
它的目標是控制 Common Lisp 系統的整個生命週期並使其自動化,
19-
包括相依性管理、打包、發行和測試。
20-
21-
- Ruby 專案有 `gemspec` 檔案嗎?
22-
- Node.js 專案有 `package.json` 檔案嗎?
23-
- Clojure 專案有 `project.clj` 檔案嗎?
24-
- Common Lisp 專案有 `Qob` 檔案嗎?
17+
對於很多新手來說, 相比其他高階語言像是 Python, Rust, 等等.
18+
Common Lisp 的入門難度是相對算高的. 主要原因並不是因為 Common Lisp
19+
這個語言本身有多難, 困難的地方通常是指它的語言環境,
20+
工具鏈不齊全, 文檔太少或不完善, 網路搜尋時常無果, 等等其他疑難雜症.
21+
22+
Qob 嘗試解決環境不友善的問題. 像是如何建構執行檔, 應該呼叫那些函式
23+
去做那些指令. 不需要進 Lisp 實踐 (ex: SBCL) 也能夠執行一系列的 Lisp 任務.
24+
相比過去 `eval` 需要執行的函式, 使用 Qob 能讓你擁有更接近現代高階程式語言
25+
的使用者體驗.
2526

2627
## 📰 消息
2728

0 commit comments

Comments
 (0)