doc: improve grammar, spelling, and fix some links

doc: resolve rebasing osdk docs

doc: improve grammar and spelling, fix links for the contributing section

fix: resolve rebasing for run.rs

fix: resolve rebasing for osdk, again

docs/src/osdk/guide/README.md

@@ -2,12 +2,12 @@
 
 ## Overview
 
-OSDK (short for Operating System Development Kit) 
+The Asterinas OSDK (short for Operating System Development Kit) 
 is designed to simplify the development of Rust operating systems.
 It aims to streamline the process 
 by leveraging [the framekernel architecture](../../kernel/the-framekernel-architecture.md). 
 
-OSDK provides a command-line tool `cargo-osdk`,
+The OSDK provides a command-line tool `cargo-osdk`,
 which facilitates project management 
 for those developed on the framekernel architecture.
 `cargo-osdk` can be used as a subcommand of Cargo.
@@ -18,7 +18,7 @@ and testing projects conveniently.
 ## Install OSDK
 
 ### Requirements
-Currently, OSDK only works on x86_64 ubuntu system.
+Currently, OSDK is only supported on x86_64 Ubuntu systems.
 We will add support for more operating systems in the future.
 
 To run a kernel developed by OSDK with QEMU,
@@ -50,14 +50,14 @@ cargo install cargo-binutils
 ### Install
 
 `cargo-osdk` is published on [crates.io](https://crates.io/),
-and can be installed by
+and can be installed by running
 ```bash
 cargo install cargo-osdk
 ```
 
 ### Upgrade
 If `cargo-osdk` is already installed,
-the tool can be upgraded by
+the tool can be upgraded by running
 ```bash
 cargo install --force cargo-osdk
 ```

docs/src/osdk/guide/create-project.md

@@ -1,6 +1,6 @@
 # Creating an OS Project
 
-OSDK can be used to create a new kernel project
+The OSDK can be used to create a new kernel project
 or a new library project.
 A kernel project defines the entry point of the kernel
 and can be run with QEMU.
@@ -112,4 +112,4 @@ The default manifest of a kernel project:
 ### `rust-toolchain.toml`
 
 The Rust toolchain for the kernel.
-It aligns with the toolchain of the Asterinas OSTD.
+It is the same as the toolchain of the Asterinas OSTD.

docs/src/osdk/guide/intel-tdx.md

@@ -1,6 +1,6 @@
 # Running an OS in Intel TDX env
 
-OSDK supports running your OS in an [Intel TDX](https://www.intel.com/content/www/us/en/developer/tools/trust-domain-extensions/overview.html) environment conveniently.
+The OSDK supports running your OS in an [Intel TDX](https://www.intel.com/content/www/us/en/developer/tools/trust-domain-extensions/overview.html) environment conveniently.
 Intel TDX can provide a more secure environment for your OS.
 
 ## Prepare the Intel TDX Environment
@@ -39,7 +39,7 @@ docker run -it --privileged --network=host --device=/dev/kvm asterinas/osdk-tdx:
 
 As Intel TDX has extra requirements or restrictions for VMs,
 it demands adjusting the OSDK configurations accordingly.
-This can be easily achieved with the `scheme` feature of OSDK,
+This can be easily achieved with the `scheme` feature of the OSDK,
 which provides a convenient way to override the default OSDK configurations
 for a specific environment.
 

docs/src/osdk/guide/run-project.md

@@ -1,6 +1,6 @@
 # Running or Testing an OS Project
 
-OSDK allows for convenient building, running,
+The OSDK allows for convenient building, running,
 and testing of an OS project.
 The following example shows the typical workflow.
 
@@ -76,12 +76,12 @@ cargo osdk test foo
 
 ## Options
 
-Both `build`, `run`, and `test` commands accept options
+All of the `build`, `run`, and `test` commands accept options
 to control their behavior, such as how to compile and
 launch the kernel.
 The following documentations provide details on
 all the available options:
 
-- [build options](../reference/commands/build.md)
-- [run options](../reference/commands/run.md)
-- [test options](../reference/commands/test.md)
+- [`build` options](../reference/commands/build.md)
+- [`run` options](../reference/commands/run.md)
+- [`test` options](../reference/commands/test.md)

docs/src/osdk/guide/why.md

@@ -9,7 +9,7 @@ This is important to Asterinas
 as we believe that the project's success
 is intricately tied to the productivity and happiness
 of its developers.
-So OSDK is here to upgrade your dev experience.
+So the OSDK is here to upgrade your dev experience.
 
 To be honest, writing OS kernels is hard.
 Even when you're using Rust,
@@ -24,7 +24,7 @@ no stack, no heap, no threads, not even the standard I/O.
 It's just you and the no_std world of Rust.
 You have to implement these basic programming primitives
 by getting your hands dirty with the most low-level,
-error-prone, nitty-gritty of computer architecture.
+error-prone, and nitty-gritty details of computer architecture.
 It's a journey of learning, doing, and
 a whole lot of finger-crossing
 to make sure everything clicks into place.
@@ -35,7 +35,7 @@ reuse OS-related libraries/crates across projects.
 Think about it:
 most applications share a common groundwork,
 like libc, Rust's std library, or an SDK.
-This isn't the case with kernels --
+This isn't the case with kernels -
 they lack this shared starting point,
 forcing each one to craft its own set of tools
 from the ground up.
@@ -83,4 +83,4 @@ as reported by [RustSec Advisory Database](https://rustsec.org).
 Despite having [a whole book](https://doc.rust-lang.org/nomicon/)
 to document "the Dark Arts of Unsafe Rust",
 unsafe Rust is still tricky to use correctly,
-even among reasoned Rust developers.
+even among seasoned Rust developers.

docs/src/osdk/guide/work-in-workspace.md

@@ -2,7 +2,7 @@
 
 Typically, an operating system may consist of multiple crates,
 and these crates may be organized in a workspace.
-OSDK also supports managing projects in a workspace.
+The OSDK also supports managing projects in a workspace.
 Below is an example that demonstrates
 how to create, build, run, and test projects in a workspace.
 
@@ -47,11 +47,11 @@ myworkspace/
           └── lib.rs
 ```
 
-At present, OSDK mandates that there must be only one kernel project
+At present, the OSDK mandates that there must be only one kernel project
 within a workspace.
 
 In addition to the two projects,
-OSDK will also generate `OSDK.toml` and `rust-toolchain.toml`
+the OSDK will also generate `OSDK.toml` and `rust-toolchain.toml`
 at the root of the workspace.
 
 Next, add the following function to `mylib/src/lib.rs`.