标签：ges   包含   配置文件   方案   des   view   覆盖   git   规范   

工程结构

├── src
├── dist
├── example
├── docs
├── index.js
├── package.json
├── README.md
├── .gitignore
└── .npmignore

src - 项目的源码，开发阶段在这个目录进行dist - 存放构建之后的文件的目录，如果不需要引用源码，则可以直接引用该目录下的文件。
examples - 示例，调用方法示例。
docs - 项目文档，如果文档内容太多，不方便全部写到 README 中，可以下 docs 目录下新建 Markdown 文件。
test - 测试，单元测试文件
index.js - 项目入口文件，package 中的入口文件默认指向此文件。package.json - npm 配置，包含项目名称、版本、依赖、作者、运行命令等基本信息。
README.md - 项目说明文件，gitlab/hub、npm 等平台会默认展示该文件的内容，作为项目介绍。
.gitignore - 配置不需要提交的 git 上的文件，通常为编译生成的文件和目录、编辑器/IDE 的配置文件。
.npmignore - 配置不需要提交到 npm 上的文件。
.npmrc - 项目级别的 npm 配置，用于设置 registry。

README.md

README.md 文件应该如下内容：

示例项目

1. 解决什么问题
   简介的描述模块的作用。
2. 如何调用
   尽量给出完整可执行的代码，如果给出伪代码，也尽量省略常识性内容。
3. 配置项
4. 已知问题 & notes
   在什么环境下会出现什么问题，如何规避。
5. 迭代计划

单元测试

组件构建之前默认调用 ‘npm chr-test‘ 进行测试。

examples

项目中应该包含一个覆盖项目大部分 API 的实例程序，如果文档表述不清楚，则调用者可以按照实例程序的方式来使用。
如果是不同种类的例子，建议分文件夹存放。

npm script

在自动构建时，构建程序会调用 npm scripts 中的命令。
也建议将项目常见的操作写成 npm script。
保留如下命令：
chr-build:
chr-test:

组件创建脚手架

 组件发布

由于 cnpmjs.org 的限制，只有在配置文件中写明的用户才能够发布组件。

所以，考虑到这个用户名单维护的成本，不计划使用每个用户都可以发布的方式。

发布方案

组件发布借助 gitlab 和 jenkins, 在组件发布工具中触发发布操作，发布工具会从对应 repo 中拉取代码，执行构建，并发布到 npm 仓库。

发布前的改动

根据本次改动，更新 README.md 与 examples 等信息，然后根据改动类型，对修改版本号，版本号更改要严格遵循

前端工程化

标签：ges   包含   配置文件   方案   des   view   覆盖   git   规范   

原文地址：http://www.cnblogs.com/coder-zyz/p/6749008.html