1
0
mirror of https://github.com/ZSCNetSupportDept/website.git synced 2025-10-28 17:05:03 +08:00

完善了快速上手指南

This commit is contained in:
2024-08-22 12:08:48 +08:00
parent c5ac642a07
commit c46c0e2557

View File

@@ -1,10 +1,13 @@
# 快速上手
修网的知识需要在实践中不断积累网维的wiki做为每一个网维成员经验的总结自然也需要不断的更新但是wiki本身大部分时间都是由开发组的仅仅几个人来维护难以时刻更新到最新情况所以我们想让网维的每个人都能加入wiki的维护这篇文章就是写给希望为wiki添砖加瓦却不太了解相关方法的小伙伴的希望这篇文章能够快速让你上手wiki的维护工作。
:::info 信息
在正式开始编辑前,你可以看看我们的成品网站,每篇文章的下面会有一个`Edit This Page`的链接,是这篇文章的源代码,这里是网站的链接:[Click Me ](https://zscdev-demo.pages.dev/)
:::
## 准备
我们假设你所使用的是windows系统。
@@ -66,6 +69,12 @@ Node.js是一个在后端运行javascript的运行时我们使用基于这个
如果没有出错的话,你会看到我们开发组网站的主页。
:::tip 提示
每次启动测试版网站,都需要在这里再输入一次`npm start`
:::
## 编辑
打开`website`下的`docs`文件夹,再打开`wiki`文件夹,这里就是我们的wiki内容仓库了。
@@ -210,7 +219,7 @@ git push
- 然后是我们的demo版本网站[zscdev-demo.pages.dev](zscdev-demo.pages.dev),这个版本立即反应了任何被合并进去主仓库master分支的更改大家可以对这个网站上的内容随便提意见任何修改都将很快被同步到网站里。
- 当主仓库和demo网站的更新积累到一定程度的数量时开发组成员会根据一个版本作为wiki的正式版正式推送到我们的网站[developer.zsxyww.com](developer.zsxyww.com)里这个版本通常要比demo要落后几次更新但是那些在施工中的文章和还在讨论的段落等不稳定的内容将不会被同步到这里换句话说这个版本是“稳定版”。
我们从debian的开发中(unstable/testing/stable)借鉴了这一模型,它可以确保最终正式的wiki是严谨的可信赖的同时将想法和讨论的场地从正式文档中分离开确保了开发的有序进行.
我们从许多大型软件例如firefox(nightly,stable,ESR),windows(canary,dev,LTSC),debian(unstable/testing/stable)的开发中,借鉴了这一模型,它可以确保最终正式的wiki是严谨的可信赖的同时将想法和讨论的场地从正式文档中分离开确保了开发的有序进行.
这样的设计是考虑了这样的场景有许多人同时参与wiki的开发而不是一年不一定更新一回的随意开发还是希望大家能多多参与到wiki的维护工作中来。。。