github.com/ecodeclub/eorm@v0.0.2-0.20231001112437-dae71da914d0/README.md (about)

     1  # EORM
     2  
     3  [![DeepSource](https://deepsource.io/gh/ecodeclub/eorm.svg/?label=active+issues&show_trend=true&token=pKgxd-FmZ5F3l0M2iXQRpBRy)](https://deepsource.io/gh/ecodeclub/eorm/?ref=repository-badge)
     4  
     5  简单的 ORM 框架。
     6  
     7  ## 使用注意事项(技术选型前必读)
     8  
     9  丑话说前头。
    10  
    11  - 目前来说,它还没有达到一个稳定的状态,在正式发布 v1.0.0 之前,你可以认为它都处于一种实验和学习状态。在这个状态下,我们并不会对 API 的稳定性做任何承诺。从这个角度来说,我们也不建议你将它用在一些核心项目里面
    12  
    13  ### Go 版本
    14  
    15  请使用 Go 1.20 以上版本。
    16  
    17  ### SQL 2003 标准
    18  理论上来说,我们计划支持 [SQL 2003 standard](https://ronsavage.github.io/SQL/sql-2003-2.bnf.html#query%20specification). 不过据我们所知,并不是所有的数据库都支持全部的 SQL 2003 标准,所以用户还是需要进一步检查目标数据库的语法。
    19  
    20  ### 全中文仓库
    21  
    22  这是一个全中文的仓库。这意味着注释、文档和错误信息,都会是中文。介意的用户可以选择别的 ORM 仓库。
    23  
    24  但是不必来反馈说希望提供英文版本,我们是不会提供的,因为:
    25  - 这个仓库目前以及可预测的将来,都不会有外国人使用。很多国内开发者的开源仓库提供了英文选项但是实际上英文用户数量感人,我就不想做这种性价比低的事情;
    26  - 双语言会导致英文用户有一些不切实际的期望,比如说在 issues 和 discussions 里面都使用英文交流。但是这对于我的目标来说,也是不现实的。因为很多国内开发者不具备这种英文能力,而且这些开发者非常倔强,即便我们一再强调请使用英文,他们也会固执使用中文。因此我索性将这个搞成全中文仓库,一了百了;
    27  - 中文终究是我的母语,所以使用中文的表达能力更加准确;
    28  - 翻译软件非常发达,真有英语用户要用,可以自己找翻译软件;
    29  
    30  ### 社区组织和讨论
    31  
    32  短时间内,我不会组建任何的微信群,QQ 群或者钉钉群之类的即时通讯群。
    33  
    34  我注意到很多开源仓库都会组织类似的群,但是这种群有利有弊,而且对于项目本身来说是弊大于利的。组建了不同的群之后会导致问题讨论被切割到不同的群里面。例如某个群讨论了 A 问题,其它群完全看不到。
    35  
    36  另外一个原因就是,因为即时通讯过于便捷,会给维护者带来庞大的维护压力。用户可能期望自己的所有答案都能从群里得到解答,因此不愿意自己花时间去读文档,读注释,读例子。在这种情况下,他们会频繁艾特维护者,并希望维护者能够实时给出详细回答。而实际情况是,一般的小项目维护者可能只有两三个人,所以没有足够的精力来维护这种群。
    37  
    38  我想要的社区是大家统一在 github 下,利用 issue 和 discussion 来讨论问题。这样别的用户都可以搜索到所有的讨论。
    39  
    40  ## 加入我们
    41  - [贡献指南](https://ekit.gocn.vip/contribution/#%E8%AE%BE%E7%BD%AE%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83)