Discord¶
与 TensorMesh 社区实时交流——获取快速帮助、参与设计讨论,以及展示您的成果。
当您希望进行快速的对话式交流时,Discord 服务器是合适的去处。对于将来用户可通过搜索找到的长篇问答,请优先使用 GitHub Discussions。对于缺陷报告和功能请求,请改为提交 GitHub Issues 条目。
加入服务器¶
Invite link: https://discord.gg/EC9kbHSnrx
The widget on the left shows who is online right now and lets you join in one click. The invite link is permanent.
服务器的主要语言是英语。
频道指南¶
服务器分为四个类别。下面的列表说明了每个频道的用途——目前大多数频道还很安静,因为社区才刚刚起步。
Information——只读的公告和基本规则。
#welcome——从这里开始。#announcements——发布、破坏性变更和活动通知。由维护者发布;如果您依赖本库,请开启通知。#rules——服务器礼仪(见下文 服务器礼仪)。
Community——开放交流。
#general——任何与 TensorMesh 相关但不适合放在其他频道的内容:有限元方法讨论、PyTorch 技巧、用机器学习求解偏微分方程的论文、相关库等。#showcase——分享您的成果。图表、动画、论文、博客文章、课程材料——都欢迎。
Help——帮您走出困境。
#help——使用问题。"我该如何装配 X?"、"为什么我的网格加载不出来?"、"用于 Y 的正确 API 是什么?"。关于应包含哪些内容,请参见下文 如何提出一个好的求助问题。#troubleshooting——安装问题、环境问题、CUDA/torch 版本冲突,以及 torch-sla 求解器后端的配置。
Development——面向编写补丁的开发者。
#dev——设计讨论、正在进行的重构,以及提交 PR 之前的 RFC 式讨论帖。维护者和贡献者常驻于此。#staff-only——供维护者协调的私有频道(发布规划、内容管理)。在此列出是为了保持透明;除非您拥有维护者角色,否则将看不到该频道。
如何提出一个好的求助问题¶
几行背景信息就能把一个无从回答的问题变成维护者一分钟内即可解答的问题:
您运行了什么——一段最小的代码片段,最好是读者可以直接粘贴到 Python shell 中运行的内容。支持三个反引号的代码格式。
您看到了什么——完整的回溯信息,而非转述。请将冗长的输出放在代码块中。
您期望什么——您想要的形状、数值或行为。
版本信息——
python -c "import torch, torch_sla, tensormesh; print(torch.__version__, torch_sla.__version__, tensormesh.__version__)"的输出,以及您的操作系统和(如相关)CUDA 版本。
如果您的问题超过几段,或者您希望答案将来可被搜索到,请将其发布到 GitHub Discussions,并在 #help 中附上链接。
服务器礼仪¶
以下是一份让服务器氛围保持愉快的简短规范清单:
请友善且耐心。许多用户正在学习有限元方法、PyTorch,或两者兼有。
让技术分歧停留在技术层面。
禁止发布垃圾信息、推广无关产品或进行骚扰。
公共频道默认使用英语;如果您粘贴非英语的错误信息,请同时翻译,以便他人能够提供帮助。
维护者可以移除违反这些规范的消息或成员。如果您发现问题,请 @``@moderator`` 或私信某位维护者。
聊天不适用的场景¶
Discord 很适合实时交流,但这种媒介也有缺点:消息会滚动消失、讨论帖未必可搜索,而且 Google 也不会索引它们。因此:
遇到缺陷? → GitHub Issues。即便是在 Discord 上的一行复现代码,最终也应整理为一个 issue。
希望长期保留的设计讨论? → GitHub Discussions。
发布公告位于 GitHub 发布页面,而非聊天记录中——如果您不想错过通知,请在那里订阅。
服务器上见。