Merge pull request qiniu#31 from qiniu/develop

Release v6.0.2

Author: xushiwei

CHANGELOG.md

@@ -1,5 +1,13 @@
 ## CHANGE LOG
 
+### v6.0.2
+
+2013-06-27 issue [#31](https://github.com/qiniu/sdkspec/pull/31)
+
+- 对 `ListPrefix` 的规格说明进行规范
+- IMPL.doc 补充了“开发流程”的规范
+
+
 ### v6.0.1
 
 2013-06-24 issue [#30](https://github.com/qiniu/sdkspec/pull/30)

IMPL.md

@@ -6,6 +6,7 @@
 
 ```
 docs/			- 文档所在目录
+tests/  		- 单元测试目录，有的语言习惯叫 test 目录。这个建议遵循社区惯例。
 README.md		- 项目说明文档
 CHANGELOG.md	- 更新日志
 .travis.yml		- Travis-CI 配置文件
@@ -24,6 +25,28 @@ before_script:
 然后在测试案例中通过 getenv("QINIU_ACCESS_KEY") 和 getenv("QINIU_SECRET_KEY") 获得 AccessKey/SecretKey。
 
 
+## 开发流程
+
+准备工作：
+
+1. fork qiniu 中的某个 sdk（比如叫 foo-sdk）
+2. git clone [email protected]:yourname/foo-sdk.git
+3. git remote add qiniu [email protected]:qiniu/foo-sdk.git
+4. git fetch qiniu
+
+开发流程：
+
+1. git checkout -b feature/yyyy qiniu/develop
+2. 开发 (如果qiniu/develop分支别人有merge内容进来，可以随时执行 git pull 合并)
+3. git commit -am "xxx"
+4. git push origin feature/yyyy
+5. 发起 pr
+
+其他一些细节：
+
+1. 如何同时开发多个feature。很简单：随时可以 git checkout feature/yyyy 到某个分支
+
+
 ## 更新日志
 
 - 版本 Tag 创建的日期

README.md

@@ -142,6 +142,9 @@ func New(mac *digest.Mac = nil) Client
 
 func (this Client) ListPrefix(
 	bucket, prefix, marker string, limit int) (entries []ListItem, markerOut string, err error)
+	// 1. 首次请求 marker = ""
+	// 2. 无论 err 值如何，均应该先看 entries 是否有内容
+	// 3. 如果后续没有更多数据，err 返回 EOF，markerOut 返回 ""（但不通过该特征来判断是否结束）
 
 type ListItem struct {
 	Key      string