首页
学习
活动
专区
圈层
工具
发布

如何阅读技术文档

答:“去看文档” “Django的文档都是英文,我看不下去,怎么办” 答:“bla bla bla…. 关于英文的重要性” “Django的文档那么多,我是不是都得看完才行?”...但是剩下的其他文档怎么办?不用看了吗?怎么个看法,据说一千多页呢! 这篇文章我根据我的想法讨论下应该如何阅读Django的文档比较合适。...再后来基本上就是用到一个模块,遇到问题,就去自己阅读相应的文档。...另外还得说说英文阅读的事儿,这是任何开发人员都绕不过的坎,关于英文对程序员的重要性网上已经有很多论述了,我这里不再添加冗余的信息了。...两种实践方法 自己一个人看东西有时还是挺无聊的,单纯的阅读也是挺无聊的,那么当你陷入这种状态之后,怎么破呢?

2.3K90
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    elasticsearch文档Update API

    通过前面两篇文章的阅读,相信读者已经熟练掌握 DeleteByQuery的用法了,本文则来继续看文档的Update API。...本文是Elasticsearch系列的第十四篇,阅读前面的文章,有助于更好的理解本文: ---- 1.elasticsearch安装与配置 2.初识elasticsearch中的REST接口 3.elasticsearch...修改数据 4.elasticsearch文档操作 5.elasticsearch API约定(一) 6.elasticsearch API约定(二) 7.elasticsearch文档读写模型 8.elasticsearch...文档索引API(一) 9.elasticsearch文档索引API(二) 10.elasticsearch文档Get API 11.elasticsearch文档Delete API 12.elasticsearch...文档Delete By Query API(一) 13.elasticsearch文档Delete By Query API(二) ---- Update API Update API允许开发者根据脚本更新文档

    2.1K20

    elasticsearch文档Delete API

    上篇文章和读者分享了Elasticsearch中文档Get API的一些基本用法,本文来看看DELETE API的基本用法。...本文是Elasticsearch系列的第十一篇,阅读前面的文章,有助于更好的理解本文: ---- 1.elasticsearch安装与配置 2.初识elasticsearch中的REST接口 3.elasticsearch...修改数据 4.elasticsearch文档操作 5.elasticsearch API约定(一) 6.elasticsearch API约定(二) 7.elasticsearch文档读写模型 8.elasticsearch...文档索引API(一) 9.elasticsearch文档索引API(二) 10.elasticsearch文档 Get API ---- Delete API允许开发者通过一个文档id删除一个JSON文档...Wait For Active Shards waitforactive_shards参数的作用和elasticsearch文档索引API(二)一文中介绍的含义一致,这里不再赘述,读者可以参考该篇文章。

    1.7K10

    elasticsearch文档Get API

    前面两篇文章和读者讨论了Elasticsearch中文档的索引API,本文来看Get API。...---- Get API是一个基于文档id,从索引中获取JSON文档的API,例如如下请求表示从twitter索引中获取一个id为1的索引: curl -X GET "localhost:9200/twitter...通过阅读前面的文章,相信大家对这个执行结果应该很熟悉了,这里的执行结果中有 _index、 _type、 _id、 _version等我们常见的信息,也有found字段表示查询的数据是否存在, _source...Realtime 默认情况下,Get API是实时的,并且不受index刷新率的影响(当数据对搜索可见时)。...如果文档已更新但尚未刷新,则Get API将发出刷新调用以使文档可见,这也会导致其他文档发生变化。如果开发者想要禁用实时GET,可以将realtime参数设置为false。

    1.6K20

    API文档管理平台

    一、应用场景 在公司中,有很多开发,每个人维护的api接口是不一样的。如果有一个统一的api文档管理平台,每个开发,把自己维护的接口录入进去。...关于api文档管理,网上有很多。有在线收费的,也有开源的。基于节省成本考虑,这里主要介绍2个开源工具:ShowDoc和YApi。 下面会详细介绍着2个工具的使用方法,都是基于docker安装的!...二、ShowDoc ShowDoc是一个非常适合IT团队的在线API文档、技术文档工具。你可以使用Showdoc来编写在线API文档、技术文档、数据字典、在线手册。...点击插入API接口模板,点击右侧的保存 可以看出,左边就是markdown格式,右边就是预览效果 ? 保存之后,点击返回,效果如下: ? ok,到这里,一个api文档就完成了。...三、YApi(推荐) 介绍 Yapi 由 YMFE 开源,旨在为开发、产品、测试人员提供更优雅的接口管理服务,可以帮助开发者轻松创建、发布、维护 API。

    5.5K20

    API文档先行还是API编码先行?

    API文档先行是在编码之前先设计好API说明,Swagger提供Open API规范的文档范式,可通过IDE插件或Swagger网站提供的在线编辑工具编辑。   ...API文档先行   前面演示的流程其实是API文档先行,先使用工具编制好API文档,然后生成代码说明模板,在这个模板上再进行详细编码,这样做的好处能够重点设计好API内容,不会被编码细节打扰,坏处是,在详细编码中如果需要调整一些入参和出参...,需要改文档,再该代码里面的API文档,比较麻烦。...API编码先行  这是传统直觉方式,把API文档看成是普通文档,写好代码再写文档,其实在REST前后端分离架构下,如果写好API文档,前后端可以同时进行开发,而且提供前端人员对你的API测试的依据,对项目演进过程中如果代码有变动...,而API文档没有修改,导致功能都无法正常运行。

    1.6K30
    领券