Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add LA reference manual 1 #17

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

add LA reference manual 1 #17

wants to merge 2 commits into from

Conversation

yetist
Copy link
Contributor

@yetist yetist commented Aug 10, 2021

增加指令集手册卷1英文文档。

预览网址: https://preview.loongarch.dev/en/docs/lav1/

@yetist yetist requested a review from a team August 10, 2021 01:54
@xen0n
Copy link
Member

xen0n commented Aug 10, 2021

反对直接嵌入整个内容,给链接就好了。否则甚至可能影响SEO。

@yetist
Copy link
Contributor Author

yetist commented Aug 10, 2021

反对直接嵌入整个内容,给链接就好了。否则甚至可能影响SEO。

不是通过框架嵌入,hugo 本来就支持 adoc 格式,这是正常用法。

不影响SEO,因为网站是分中文站和英文站的,英文站一直没内容,正好放手册。

@xen0n
Copy link
Member

xen0n commented Aug 10, 2021

反对直接嵌入整个内容,给链接就好了。否则甚至可能影响SEO。

不是通过框架嵌入,hugo 本来就支持 adoc 格式,这是正常用法。

反对的正是这种做法,给个链接到 loongson.github.io 的相应手册页面就好了,不必要整个正文都拉进本 repo 来。

不影响SEO,因为网站是分中文站和英文站的,英文站一直没内容,正好放手册。

不能因为没内容就硬找,而是应该把中文贴子都翻译一遍,不要搞两个内容不同的站出来,脸面上不好看,这届网友不认这一套的。

@yetist
Copy link
Contributor Author

yetist commented Aug 10, 2021

反对的正是这种做法,给个链接到 loongson.github.io 的相应手册页面就好了,不必要整个正文都拉进本 repo 来。

没看出来你反对这么做的真正原因是啥,是担心和原始内容不同步?还是担心版权亦或授权问题?我觉得这个性质的网站提供指令手册是非常正常的呀。

不能因为没内容就硬找,而是应该把中文贴子都翻译一遍,不要搞两个内容不同的站出来,脸面上不好看,这届网友不认这一套的。

网站建立之初确实是这个打算,不过编写英文(其实就是翻译成英文)和对英文审核,确实存在困难,从 #5 的情况就能看出来,挂了半年都没人愿意review。如果有人愿意帮忙保持英文站和中文站同步那最好不过了。

至于说到脸面不好看,我觉得英文站把指令手册(以后如果有中文版自然会多语言)放上去,总比挂几篇模板自带的文章(主要是没内容,也没人对生产内容感兴趣)要好吧? 。
本来打算英文站把手册放上去之后,统一把这些早期用来占位的文章给处理掉的,现在按你的想法,我看这些占位文章还得继续挂着...

@loongarch64/dev-team 其他人对这个 PR 有什么看法?欢迎讨论。

@zhuyaliang
Copy link

这个有什么更新吗?

@xen0n
Copy link
Member

xen0n commented Oct 13, 2021

反对理由不变:加入大量与其他网站页面相同的内容会导致两个站被判定为内容重复(稀释),降低权重,从 SEO 角度不利于站点的曝光。作为“开发团队技术博客”性质的网站,给到链接足矣(顺带一提,这反而会增加两边的权重,有利于 SEO)。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants