docs

docs copied to clipboard

zapcannon87

文档首页在 Windows 下切换公开课与文档产生的样式问题

7

由于文档页面较长，视频公开课页面较短，因此在 Windows 下文档页面会因为右侧出现的滚动条而让整个页面宽度变短。 这种情况下，由于文档首页中的元素多为居中排列，整个页面宽度的变化会导致居中元素产生水平位移。 Mac 下由于滚动条自动隐藏，因此感知不到。Windows 下很明显。

nervouna

现在这两个语言的文档是各自独立的，没有像其他语言一样共享一套主模版。可以有时间整理一下，方便日后维护。

ghost

RTM 指南第 4 章「打造自己的聊天机器人」

1

https://leancloud.cn/docs/realtime-guide-systemconv.html#hash-1429079363 现状是： > 这部分内容我们还在准备中，敬请期待。 有一篇 2016 年的关于聊天机器人的博客：https://zhuanlan.zhihu.com/p/21399155 配套的 GitHub 仓库：https://github.com/hjiang/role-model

weakish

[feat] 为存储和聊天添加一些性能上不推荐开发者使用的方式

1

例如正则匹配查询这种就应该少用，与此类似的还有其他的一些禁忌，我们可以逐步总结一些单列一个文档，并且在 SDK 介绍对应的方法和接口的时候给出链接。

wujun4code

### 假设前提：实现微信朋友圈的功能 功能点 1. [x] 给朋友圈点赞 2. [x] 查看本条朋友圈有哪些人点了赞 如果单纯上面两个功能，那么假定朋友圈对象是一个 AV.Object('Moment') 那么最好的存储方式如下: ```js let moment = new AV.Object('Moment'); moment.addUnique('likes',AV.User.current().objectId); moment.save(); ``` 上述的实现最大的问题是在朋友圈逐渐增多之后，会出现如下功能查询的缓慢（参照聊天目前 _Conversation 表里面的 m 列的慢查询问题） > 查看当前用户给多少条朋友圈点赞 因此，根本 @sdjcw...

wujun4code

阅读文档过程中的一个常见场景是用户点击文档内某个链接来了解更多内容。目前的设定是在当前窗口打开链接，这样新打开的页面会取代当前文档。不过如果用户想需要同时阅读当前文档和新页面的内容（例如点击指向控制台的链接并照着文档操作控制台），或者在浏览完新页面后想要回到当前文档，那么用户的阅读过程可能会被打断，尤其是对不熟悉文档程序用户界面的新用户来说（老用户在发现这个规律后可能会习惯右键新窗口打开，不过还是要多一次操作）。 我的一个提议是对于任何指向当前文档以外的链接（包括指向其它文档的、指向控制台的、指向其它网站的）都在新窗口打开。指向当前文档其他部分的链接（`[XX](#xx)`）也许可以依旧在当前页面跳转，因为比较容易返回。

ghost

考虑为 Restful API 提供结构化的文档

1

目前 SDK 的文档大都分为「教程」和「API 参考」，但 Restful API 只有一份教程性质的文档，对参数和返回值的类型标注得不是很清晰，也不便于查询。

jysperm

在文档标题下增加自定义标签，便于用户搜索

8

在标题下方增加对用户更熟悉的关键字（标签），帮助用户更快地定位内容。前后对比效果如下： --- 示例链接：https://leancloud.cn/docs/realtime_guide-ios.html#群聊 ``` ## 群聊 对于多人同时参与的固定群组，我们有成员人数限制，最大不能超过 500 人。对于另外一种多人聊天的形式，譬如聊天室，其成员不固定，用户可以随意进入发言的这种「临时性」群组，后面会单独介绍。 ``` 请前端工程师设计好 CSS 和 HTML tag，文档写作者在 md 文档中加入标签。 该标签没有超链接，只是普通文字。 另外请考虑当标签较多时，折行显示时不要交叠在一些。

myleslee

我发现有很多用户用 PHP 来做推送，而且很多人都不清楚如何使用 where 参数，需要在文档上补充相关的示例。 https://github.com/leancloud/php-sdk/blob/master/src/LeanCloud/LeanPush.php#L148

jysperm