Skip to content

Commit e3f270f

Browse files
committed
Updated readme.md
1 parent 9961530 commit e3f270f

File tree

1 file changed

+8
-56
lines changed

1 file changed

+8
-56
lines changed

README.md

Lines changed: 8 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,12 @@
1-
# Wordpress Engineering Handbook based on Astro + Starlight
1+
![Travelopia Logo](https://raw.githubusercontent.com/Travelopia/wordpress-engineering-handbook/99615309358a8fb97b40889fea3ecdf2ed6d17dd/src/assets/images/travelopia-logo.svg "Travelopia")
22

3-
## 🚀 Project Structure
3+
# Wordpress Engineering Handbook
4+
> This handbook serves as a comprehensive resource for engineers at Travelopia. It provides guidelines, best practices, and essential information for various engineering processes and systems.
45
5-
Inside you'll see the following folders and files:
6+
[Check out Handbook 📖](https://wordpress-handbook.travelopia.com/)
67

7-
```
8-
.
9-
├── public/
10-
├── src/
11-
│ ├── assets/
12-
├── css/
13-
├── images/
14-
│ ├── content/
15-
│ │ ├── docs/
16-
│ │ └── config.ts
17-
│ └── env.d.ts
18-
├── astro.config.mjs
19-
├── package.json
20-
└── tsconfig.json
21-
```
8+
# How to Use This Handbook
9+
This handbook is designed to be a living document. We encourage you to use the table of contents to quickly find the information you need. If you cannot find what you're looking for, please reach out to the engineering handbook maintainers.
2210

23-
Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
24-
25-
Images can be added to `src/assets/` and embedded in Markdown with a relative link.
26-
27-
Static assets, like favicons, can be placed in the `public/` directory.
28-
29-
## 🧞 Commands
30-
31-
All commands are run from the root of the project, from a terminal:
32-
33-
| Command | Action |
34-
| :------------------------ | :----------------------------------------------- |
35-
| `npm install` | Installs dependencies |
36-
| `npm run dev` | Starts local dev server at `localhost:4321` |
37-
| `npm run build` | Build your production site to `./dist/` |
38-
| `npm run preview` | Preview your build locally, before deploying |
39-
| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
40-
| `npm run astro -- --help` | Get help using the Astro CLI |
41-
42-
43-
## Steps to add a new guide.
44-
45-
1. Create a new `.mdx` file in the `src/content/docs/` directory.
46-
2. Add the [frontmatter]([frontmatter](https://starlight.astro.build/reference/frontmatter/)) to the top of the file. Here is an example:
47-
```md
48-
---
49-
title: "New Guide"
50-
description: "This is a new guide"
51-
template: doc # This is the template for the guide, you can use `doc` or `splash`
52-
---
53-
```
54-
3. Add the content to the file.
55-
4. (Optional) Add the link to the guide in the `src/content/docs/index.mdx` file.
56-
5. Update the listing in `astro.config.mjs` to include the new guide.
57-
58-
## 👀 Want to learn more?
59-
60-
Check out [Starlight’s docs](https://starlight.astro.build/) or read [the Astro documentation](https://docs.astro.build).
11+
# Contributing to the Handbook
12+
We welcome contributions to improve the handbook. If you have suggestions, corrections, or new content to add, please submit a pull request or create an issue on the handbook's repository. Please refer to our [Contributing Guidelines](https://github.com/Travelopia/wordpress-engineering-handbook/blob/main/contributing.md) for detailed instructions.

0 commit comments

Comments
 (0)