V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
qloog
V2EX  ›  推广

没有示例的开源项目都是耍流氓

  •  
  •   qloog · 2020-05-25 17:40:10 +08:00 · 2581 次点击
    这是一个创建于 1403 天前的主题,其中的信息可能已经有所发展或是发生改变。

    作为一个开源项目,如果没有一个好的 example,用户是很难上手的,比较知名的项目基本都有提供,所以我在项目中也加入了一个示例。

    这个示例主要是通过一个用户模块来了解项目中的各层之间如何进行协作,具体如何使用。

    项目地址:https://github.com/1024casts/snake

    该用户模块包含以下功能:

    • 注册
    • 登录(邮箱登录,手机登录)
    • 发送校验码(使用七牛云服务)
    • 更新用户信息
    • 关注 /取消关注
    • 关注列表
    • 粉丝列表

    通过该模块可以学到该框架的如下用法:

    • 如何面向接口编程
    • handler 、service 、repo 、model 之间如何进行调用
    • 数据库 db 如何使用
    • 如何使用数据库事务
    • 错误应该在哪一层进行处理
    • 日志应该在哪一层进行打印
    • 外对输出的数据如何进行统一转换处理
    • 等等...

    通过阅读项目中的代码即可了解具体的实现。

    大家的开源项目中有提供示例么?

    如果大家有任何问题或者建议,欢迎一起交流、讨论、提 PR 。
    喜欢的话给来个 Star: https://github.com/1024casts/snake

    第 1 条附言  ·  2020-05-25 18:17:28 +08:00
    本项目是一个 Go 项目,想学习用 go 开发的可以看看。
    第 2 条附言  ·  2020-05-25 18:37:17 +08:00
    说明下:本项目说的示例主要是针对稍微完整点的示例模块。当然大部分开源项目是提供某个功能点的示例,比较单一的那种,更复杂的用法还需要使用者自己去琢磨。
    musi
        1
    musi  
       2020-05-25 17:57:07 +08:00   ❤️ 5
    你这个帖子发的就有点耍流氓,要是不点进去看一下你的项目根本没人知道你的项目是 Go 的。
    这个帖子除了让别人知道你是来推广你的项目之外根本没有其他有用的信息
    qloog
        2
    qloog  
    OP
       2020-05-25 18:08:57 +08:00
    @musi 这点还真给漏了 😢 ,是个 Go 项目
    kumasama
        3
    kumasama  
       2020-05-25 18:23:25 +08:00
    楼主以前是干销售的吧?
    loading
        4
    loading  
       2020-05-25 18:27:14 +08:00 via Android
    没有线上 demo,真流氓。
    qloog
        5
    qloog  
    OP
       2020-05-25 18:27:44 +08:00
    @kumasama 😢,还真不是呢
    ben1024
        6
    ben1024  
       2020-05-25 18:27:51 +08:00
    看了题目还想怼下楼主的观点,开源的开发者没有义务去做示例
    qloog
        7
    qloog  
    OP
       2020-05-25 18:29:39 +08:00
    @loading 这种 API 的主要是看具体的示例代码,不是那种演示站。
    qloog
        8
    qloog  
    OP
       2020-05-25 18:33:33 +08:00
    @ben1024 好一点的开源项目基本都有,只是大部分是基于某个小功能的示例,按功能模块的确实不多。我主要是针对这种功能模块的。 这么说来标题起的确实不太好。但是已经木法改了,大家知道就好了。
    renmu123
        9
    renmu123  
       2020-05-25 19:24:35 +08:00 via Android
    validator 最新版本已经是 v10 了
    zxcslove
        10
    zxcslove  
       2020-05-25 19:38:06 +08:00
    说了也没啥用,江山易改本性难移,一人一个做法,人家连开源都没义务不是?
    lechain
        11
    lechain  
       2020-05-25 20:33:44 +08:00 via Android
    参考 Linux kernel ??黑人❓
    zhw2590582
        12
    zhw2590582  
       2020-05-25 20:35:54 +08:00
    标题党
    a62527776a
        13
    a62527776a  
       2020-05-25 20:36:15 +08:00
    花式推广 我去
    lwlizhe
        14
    lwlizhe  
       2020-05-25 20:49:05 +08:00
    本来还以为是对线帖,没想到是推广……
    nianyu
        15
    nianyu  
       2020-05-25 20:54:01 +08:00
    没有 demo 没有 example 我是没有心情用的。当然你可以说作者没有义务做这些。无所谓我也有权利不用这些粗制滥造的开源垃圾
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5533 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 33ms · UTC 06:39 · PVG 14:39 · LAX 23:39 · JFK 02:39
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.