Skip to content

Commit

Permalink
docs: Update intro
Browse files Browse the repository at this point in the history
  • Loading branch information
jcs090218 committed Nov 30, 2024
1 parent 8bf8737 commit eca9a55
Show file tree
Hide file tree
Showing 2 changed files with 23 additions and 16 deletions.
22 changes: 14 additions & 8 deletions docs/content/Getting-Started/Introduction/_index.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,20 @@ tools like [Roswell][] and [Qlot][], which only serve specific goals.

## ❓ Why Qob?

Qob is an Common Lisp project management tool, similar to Maven or Leiningen.
It aims to control and automate the entire life cycle of an Common Lisp system,
including dependency management, packaging, distribution and testing.

- Ruby projects have a `gemspec` file?
- Node.js projects have a `package.json` file?
- Clojure projects have a `project.clj` file?
- Common Lisp projects have a `Qob` file?
For many newcomers, getting started with Common Lisp can feel relatively
easy compared to other advanced languages like Python or Rust.
However, it is also perceived as a challenging language to begin with.
This difficulty doesn't stem from the language itself but rather from the
ecosystem: the environment, toolchain, sparse documentation, limited search
results, and other complexities can create obstacles.

Qob aims to address these challenges by making the environment more accessible.
It simplifies tasks such as building executables and determining which functions
to call for specific commands. Qob allows users to perform various Lisp
operations without directly interacting with a Lisp implementation (e.g., SBCL).
By using Qob, you can enjoy a user experience closer to that of modern
high-level programming languages, avoiding the reliance on the traditional
`eval`-based workflows.

## 📰 News

Expand Down
17 changes: 9 additions & 8 deletions docs/content/Getting-Started/Introduction/_index.zh-tw.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,15 @@ Qob 嘗試在這些事情上做得很好:

## ❓ 為什麼選擇 Qob?

Qob 是一個 Common Lisp 專案管理工具,類似於 Maven 或 Leiningen。
它的目標是控制 Common Lisp 系統的整個生命週期並使其自動化,
包括相依性管理、打包、發行和測試。

- Ruby 專案有 `gemspec` 檔案嗎?
- Node.js 專案有 `package.json` 檔案嗎?
- Clojure 專案有 `project.clj` 檔案嗎?
- Common Lisp 專案有 `Qob` 檔案嗎?
對於很多新手來說, 相比其他高階語言像是 Python, Rust, 等等.
Common Lisp 的入門難度是相對算高的. 主要原因並不是因為 Common Lisp
這個語言本身有多難, 困難的地方通常是指它的語言環境,
工具鏈不齊全, 文檔太少或不完善, 網路搜尋時常無果, 等等其他疑難雜症.

Qob 嘗試解決環境不友善的問題. 像是如何建構執行檔, 應該呼叫那些函式
去做那些指令. 不需要進 Lisp 實踐 (ex: SBCL) 也能夠執行一系列的 Lisp 任務.
相比過去 `eval` 需要執行的函式, 使用 Qob 能讓你擁有更接近現代高階程式語言
的使用者體驗.

## 📰 消息

Expand Down

0 comments on commit eca9a55

Please sign in to comment.