V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
huntzhan
V2EX  ›  分享创造

在筹备自己的开源项目文档,敬请不吝赐教!

  •  
  •   huntzhan ·
    huntzhan · 212 天前 · 2421 次点击
    这是一个创建于 212 天前的主题,其中的信息可能已经有所发展或是发生改变。

    刚刚写完第一页《概述》,想了解一下大家读完的真实想法:

    https://the-vkit-x.feishu.cn/wiki/wikcnblgKy8YlUIqAL14WgfJQXe

    第 1 条附言  ·  211 天前
    合并了大多数 GIF ,优化了图片,希望大家再试试看会不会卡
    第 2 条附言  ·  209 天前
    经过大家反馈后,我最终弃用了飞书,转向使用 docusaurus + vercel 部署文档。
    见: https://v2ex.com/t/892785
    28 条回复    2022-11-07 21:43:10 +08:00
    PMR
        1
    PMR  
       212 天前 via Android
    效果图适当就够

    License 写上
    huntzhan
        2
    huntzhan  
    OP
       212 天前
    @PMR 感谢,License 加上了。效果图放得应该挺克制了,我还有很多😂
    wzw
        3
    wzw  
       212 天前 via iPhone
    飞书有这个功能了?
    daiv
        4
    daiv  
       212 天前
    @huntzhan #2 如何做到不要登录就能给 任何人查看的? [用来写产品文档挺好的, 还可以实时更新, 比 vuepress 方便]
    huntzhan
        5
    huntzhan  
    OP
       212 天前
    @wzw 飞书知识库,我觉得很赞。原本是打算用 docusaurus 搭一个文档站点的,但调研发现飞书知识库已经能满足我的文档需求了,于是就不想折腾了😂。不过飞书知识库似乎不会被搜索引擎收纳,这是一个问题。
    huntzhan
        6
    huntzhan  
    OP
       212 天前
    @daiv https://www.feishu.cn/hc/zh-CN/articles/328843312369
    注意,那个分享按钮被移动到了页面下方,在设置按钮的右边,我找了好久才找到,感觉挺反直觉的。
    pansongya
        7
    pansongya  
       212 天前 via iPhone
    项目牛逼 希望可以有比较详细的使用说明 另外为啥用飞书 还要有登录限制
    huntzhan
        8
    huntzhan  
    OP
       212 天前
    @pansongya

    > 希望可以有比较详细的使用说明
    在写了😂

    > 另外为啥用飞书 还要有登录限制
    有登陆限制吗?应该是不需要登陆就能访问的呀
    ZxBing0066
        9
    ZxBing0066  
       212 天前
    飞书这。。也太卡了吧 😂
    TYTheKing
        10
    TYTheKing  
       212 天前
    可恶,居然是小黑子[doge]
    nipao
        11
    nipao  
       212 天前
    飞书文档,看上去很美好,其实用户打开的体验太差。
    利用 github 自己搭建的成本也不高,或者用 thoughts ,写作、浏览体验比飞书文档好太多
    939630029
        12
    939630029  
       212 天前
    好像很厉害
    shawndev
        13
    shawndev  
       212 天前
    logo 整挺好。
    huntzhan
        14
    huntzhan  
    OP
       212 天前
    @ZxBing0066
    想要请教一下,“飞书太卡”具体是指的是 1) 页面从加载到看到文字的时间太长,还是指 2) 页面内元素(比图图片)加载时间太长,或是指 3) 其他方面的卡顿?

    我确实在这个页面里放了很多 GIF ,可能是一个问题。
    huntzhan
        15
    huntzhan  
    OP
       212 天前
    @nipao 可以分享一下您觉得飞书“用户打开的体验太差”的方面吗?
    huntzhan
        16
    huntzhan  
    OP
       212 天前
    @TYTheKing 🐔🏀
    huntzhan
        17
    huntzhan  
    OP
       212 天前
    Thecosy
        18
    Thecosy  
       211 天前
    可以,但是打开有点慢
    nasa
        19
    nasa  
       211 天前
    飞书知识库 会不会以后公网分享需要开会员呢?
    noparking188
        20
    noparking188  
       211 天前
    这个项目能用来识别调查问卷的内容吗
    huntzhan
        21
    huntzhan  
    OP
       211 天前
    @noparking188 识别调查问卷需要的是 OCR 软件,这个项目是用来“制造”OCR 算法服务的,所以单看这个项目,答案是不行。如果结合我们即将发布的 OCR 软件,就可以😄
    noparking188
        22
    noparking188  
       211 天前
    @huntzhan #21 谢谢回答,期待发布
    ZxBing0066
        23
    ZxBing0066  
       211 天前
    @huntzhan 首次加载速度很慢,可以看看 lighthouse 指标,有些拉垮,首次资源加载也着实多了些
    ZxBing0066
        24
    ZxBing0066  
       211 天前
    @huntzhan 现在比昨天好多了,不过为啥 gif 图会影响整个页面的加载,也有点奇怪,图片全都 base64 打进去了吗
    huntzhan
        25
    huntzhan  
    OP
       211 天前
    @ZxBing0066 感谢。综合测试下来目前已经放弃使用飞书知识库托管项目文档,原因:1) 加载速度慢,普遍反应需要加载 5~10s 才能出现页面 2) 有不小的概率( 10% 的受访用户)表示完全加载不出来页面。
    ZxBing0066
        26
    ZxBing0066  
       210 天前   ❤️ 1
    @huntzhan 嗯,可以试试 docusaurus + vercel/各种 pages + cloudflare 加速感觉够用了
    deacyn
        27
    deacyn  
       209 天前 via iPhone
    @huntzhan 确实加载缓慢
    samzong
        28
    samzong  
       206 天前
    @nasa #19 背刺语雀 😅
    关于   ·   帮助文档   ·   博客   ·   nftychat   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   4796 人在线   最高记录 5634   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 44ms · UTC 08:38 · PVG 16:38 · LAX 01:38 · JFK 04:38
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.