現在 custom/ 和 fonts/ 和 images/ 是混著用的，有多處文件重複

请 sdk 的同事确认。

现在的文档概念还是很抽象，收到很多用户反馈不是太会用。
可以写个整体概念的，就是包括有好友关系，好友关系怎么弄之类的。
其他具体的 SDK 可以也补充上自己的相关内容。

先记录在此。

https://github.com/Kapeli/Dash-User-Contributions#contribute-a-new-docset

• 关联怎么获取
• 查询
• 更详细的例子

@ufosky 这个可以参考 parse

https://parse.com/tutorials/ios-push-notifications 第四步。

之前在 V2 提过一次，你们的文档在 Ubuntu 14.04 的 Chrome 下，文字大小不一致。

源自 #250 （已合并）。
这里记下来，以后慢慢实现。

现在文档部署到美国节点的时候， REST API 上显示的仍然是 cn.avoscloud.com 作为 REST API 地址，对那边环境的用户造成错误的提示。

比网页，Github 上直接改 Readme.md 来得更敏捷些，也更方便配图。Github 上也有不少这样的汇总项目，如 android-open-project ，awesome-ios-ui 。

没有问题的话，将链接至 https://github.com/leancloud/leancloud-demos

目前调整之后显得不太有条理，内容关联性也不好。

一般来说我是直接看的对应平台的xx指南，但其实有时候有些重要的东西在总览里面才有，希望能够合并到一起，方便查看，如果合并比较麻烦，可以考虑在xx指南里面写出相应标题，给出链接也行（虽然指南顶部有总览的链接，但并不方便查看 给出具体标题也是好的）

另外，如上所说 总览里面的REST推送部分，竟然包含了我找了很久的 Android平台 推送返回的json格式（一直到我实际测试得到json结果后无意中才看到这个部分） 所以我希望能够改进一下 :)

结合一个聊天 app，来讲怎么使用 im sdk 构建出来。

iOS：whereKey:sizeEqualTo:

@jwfing TODO，先记下来。

应在-keep class com.alibaba.fastjson.* { ;}
前添加上-dontwarn com.alibaba.fastjson.

-> https://github.com/leancloud/avfr/issues/176

freewing99 commented on Jan 13
精确到天即可，这个时间在html渲染的时候，读取一下github上 当前的 md 文档最后被更新的时间即可。
格式我建议是：2015-01-04 这种国际通俗易懂的即可。

wangxiao commented on Jan 13
好建议，文档更新日期挺重要的。

sunchanglong commented on Jan 14
上次 @sparanoid 还说加一个 文档的 对应 GitHub 地址

sunchanglong commented on Jan 14
如果在加上 一个类似 History 链接呢

sparanoid commented on Jan 14
當時我參考了 Linode 的文檔：
https://www.linode.com/docs/getting-started

wangxiao commented on Jan 14
行，就是有个「文档更新历史」之类的可查的链接也行。

sparanoid commented on Jan 14
我覺得主要目的是可以讓用戶看到我們的文檔有錯誤或者不足時直接就可以轉到 GitHub 那邊 fork 或者提 issue（大概就是 Linode 那樣）

wangxiao commented on Jan 14
更新时间也很重要的。
我之前基于 Google 开发就遇到过类似问题，前一天还支持的接口，第二天发现文档里面找不到了，
后来看了下更新日期，才发现晚上更新了文档。
文档变成新的接口了，没有更新日期的化，真是死无对证了。

sunchanglong commented a day ago
尝试了利用 GitHub API ，获取更新日期以及相关信息，在 build 文档的时候处理。
1 get contents by md dir path.
2 遍历每个 md 文件的 commit 信息。（path = md 文件名）
可以实现，但是遇到 API rate limit 的问题，build 多次就会出问题。暂时还没有想到其他方案。

@leancloud/developers

文档这个 repo 在创建初期的时候，由于多人撰写导致排版、格式很不规范，我统一使用了 vinta/paranoid-auto-spacing 用来自动规范排版。这个 lib 的主要功能就是在应该有空格的地方加上空格，让文档总体上看起来舒服一些

但这并不是一个完美的解决方案

比如我们的文档中经常会有全角／半角标点用错：

LeanCloud平台提供了一个移动App的完整后端解决方案,我们的目标是完全消除写 后端代码和维护服务器的必要性.

我们的 JavaScript SDK 基于流行的 Backbone.js 框架.它与已经存在的 Backbone程序是兼容的,只需要在你的代码中做出一点点改变,我们的最小化 配置,让你很快地用在LeanCloud上使用JavaScript和HTML5.

又或者名词大小写不规范的情况出现：

公开AVAnalytics.h头文件，osx可以使用统计功能了。
…
在LeanCloud上你可以为你的每一个移动应用创建一个App,每一个App都有它专属 的App id和App key.你在LeanCloud上的账户可以容纳多个App.对每一个应用你都 可以部署不同的版本到测试或生产环境.

单纯的选择自动排版，只会让我们和贡献者继续忽略这些细节，所以从现在开始，我 禁用掉了 pangu.page_spacing();，这样各位可以明显的看出来哪些文档还有排版问题，希望各位可以在今后的修改中陆续完善现有文档的排版、并将这个传统保持下去

谢谢大家

下面是有用的链接：

• 我们的文案规范：open.avoscloud.com/copywriting-style-guide.html
• 文案排版指北：sparanoid/chinese-copywriting-guidelines
• 一些其他团队的排版／写作风格标准：khowarizmi/Style-Guidelines

可以在各个文档，以及相关文档入口增加「帮助完善文档」这个链接，就是直接链接到文档的 repo。

https://leancloud.cn/docs/realtime_v2.html#云代码签名范例

如 appid:xxxx selfId:selfId ，最后的签名结果是 signature : 5fd6...

「事件流系统」不太好理解。

例如 http://github.com/leancloud/docs/blob/master/md/rest_api.md 文件中，JavaScript 写成了 Javascript。先在这里记下来，有时间去修复。

JS 保存保量一节

var GameScore = AV.Object.extend("GameScore");
var gameScore = new GameScore();
gameScore.set("score", 1337);
gameScore.set("playerName", "Sean Plott");
gameScore.set("cheatMode", false);

开发者很容易在局部变量使用，造成栈溢出。

https://leancloud.cn/docs/cloud_code_guide.html
里面「Cloud 函数」的锚点写成了 https://leancloud.cn/docs/cloud_code_guide.html#cloud-函数 ，应该是 https://leancloud.cn/docs/cloud_code_guide.html#Cloud_函数

独立的标题「微信开发」
相关能够使用到的功能等。

See https://github.com/leancloud/avfr/issues/315

我问了 zhiwei 才找到那个ssl证书的下载位置。

备忘。

https://github.com/leancloud/docs/blob/master/md/relation_guide.md

像上面的backgroud image 和 welcome message ，好让开发者知道有这样好用的功能。

Android 的设计是通过反射获取成员，_lctype 之外可以有其它任意的一级字段。

iOS这边是 TypedMessage 的一级字段只能有_lctype，_lctext和_lcattrs、_lcloc原有的属性，因为定义了一个大的对象，AVIMDynamicObject，里面有所有location，attrs等，然后从里面得到 json 。所以，当定义了如 nickname 的一级字段的时候，无法生成相应的content。

iOS 改成 Android 那样估计略麻烦，而且这么自由没多大必要。所以，建议补充文档：

用户自定义消息，一级字段只能有_lctype 和_lcattrs，扩充的其它字段得放在_lcattrs

Android 自定义消息的参考实现，
https://github.com/leancloud/leanchat-android/blob/master/app/src/main/java/com/avoscloud/chat/entity/AVIMUserInfoMessage.java

iOS 自定义消息的参考实现，

https://github.com/leancloud/leanchat-ios/blob/master/leanchat-ios/AVOSChatDemo/models/AVIMUserInfoMessage.m

对于这种情况可以讨论一下，

@ufosky @lbt05 @jwfing

没问题的话，就得补充下文档了。已经有用户掉坑里了。

-> https://github.com/leancloud/avfr/issues/248

该字段是否可以通过 equalTo 来查询。当 include 时，该字段是否也会被 include 进去，出现在返回结果中。举一两个使用例子？

用户说到一个挺好的例子，匿名发帖，把真实作者的字段设为客户端不可见。

@killme2008

这样方便开发者判断文档是否滞后。 @sunchanglong

导出数据
这里对于导出数据的描述不准确

我们还支持您可以导出所有的应用数据（不包括用户密码）

这里应该是

我们还支持您可以导出所有的应用数据（包括加密后的用户密码）

All the links of images are invalid. Maybe we should upload the images in this repository.

Android实时通信SDK文档中

AVIMClient imClient = AVIMClient.getInstance("Tom");
imClient.open(new IMClientCallback(){
  @Override
  public void done(AVIMClient client, AVException e) {
    if (null != e) {
      // 出错了，可能是网络问题无法连接 LeanCloud 云端，请检查网络之后重试。
      // 此时聊天服务不可用。
      e.printStackTrace();
    } else {
      // 成功登录，可以开始进行聊天了（假设为 MainActivity）。
      Intent intent = new Intent(currentActivity, MainActivity.class);
      currentActivity.startActivity(intent);
    };
  }
});

这一段里的new IMClientCallback(){...}应该改为new AVIMClientCallback(){...}
前者不存在这个类。

@freewing99