• Home
  • Categories
  • WIKI
  • LANGUAGE: en
    • [Topic DIscussion] deepin 文档架构重整
    deepin Talks 1.3w views · 30 replies ·
    Tofloor
    poster avatar
    longlong
    deepin
    Community Developer
    2023-02-22 17:13
    Author

    大家好，我是deepin 文档SIG的负责人，也是deepin wiki的参与者，现阶段准备对deepin提供的文档进行重整，整理后的文档架构如下：

    image.png

    目标是分离各个文档的功能，能给予新手小白和系统老鸟一个完美的文档体验。目前deepin wiki和guide还在改造过程中，dtk的doxygen文档已经初步发布，还在不断完善中。欢迎大家加入deepin wiki SIG 以及 deepin doc doc go SIG为我们的wiki和文档做出贡献

    Reply Favorite View the author
    All Replies
    1 / 2
    To page
    xuqi
    deepin testing team
    2023-02-22 17:18
    #1

    like

    • 赞一个~
    Reply View the author
    fuuko
    deepin
    2023-02-22 17:19
    #2

    文档建议像Qt那样分为两个部分，一个负责陈列API接口说明，另外一个负责收录demo和FAQok

    当然也不是说非要分两个文件放，能有机结合在一起是最好的

    Reply View the author
    longlong
    deepin
    Community Developer
    2023-02-22 17:26
    #3
    fuuko：

    文档建议像Qt那样分为两个部分，一个负责陈列API接口说明，另外一个负责收录demo和FAQok

    当然也不是说非要分两个文件放，能有机结合在一起是最好的

    是这样的。你可以看看我们现在的doxygen文档，并且以后社区优秀的demo可以给放在HOWTO里面

    Reply View the author
    pzm9012
    Moderator
    2023-02-22 17:45
    #4

    我个人还有一个想法 https://bbs.deepin.org/post/248197 ，但由于精力有限暂时没有做

    Reply View the author
    神末shenmo
    deepin
    Spark-App
    Q&A Team
    2023-02-22 17:47
    #5

    活着就是为了coding！

    Reply View the author
    joo
    deepin
    2023-02-22 17:52
    #6

    留个脚印先，备用

    Reply View the author
    longlong
    deepin
    Community Developer
    2023-02-22 17:55
    #7
    pzm9012：

    我个人还有一个想法 https://bbs.deepin.org/post/248197 ，但由于精力有限暂时没有做

    guide就是干这个事情的。从小白到大神的路（

    Reply View the author
    coder潘
    deepin
    2023-02-22 22:38
    #8

    wiki 最好弄成像archwiki那样的，可类似双链笔记的，类似meidiawiki 这种开源的，这种编辑/维护体验比较好

    Reply View the author
    myml
    Super Moderator
    Developer
    2023-02-23 02:16
    #9

    https://guide.deepin.org 已上线，大家一起 添砖加瓦(github)

    tail

    Reply View the author
    Lwh2008-Equinox
    deepin
    2023-02-23 02:27
    #10

    话说有没有一个离线版本

    Reply View the author
    hanzn-zzx
    deepin
    2023-02-23 03:18
    #11

    like

    Reply View the author
    kingskill
    deepin
    2023-02-23 05:02
    #12

    可以可以。 tail

    Reply View the author
    anye7up
    deepin
    2023-02-23 05:11
    #13

    小小建议:

    左侧的目录最好不要缩进,或者是可拉宽或滚动,否则层级一深就看不全了.

    截图_选择区域_20230222211014.png

    Reply View the author
    要讲武德
    deepin
    2023-02-23 05:12
    #14

    截图_选择区域_20230222211119.png

    链接和文字中间空一格是不是可读性更好呢

    Reply View the author
    longlong
    deepin
    Community Developer
    2023-02-23 20:16
    #15
    要讲武德：

    截图_选择区域_20230222211119.png

    链接和文字中间空一格是不是可读性更好呢

    收到！

    Reply View the author
    lizhu
    deepin
    2023-02-23 23:17
    #16

    agree

    Reply View the author
    晚秋（lateautumn）
    Moderator
    2023-02-24 00:29
    #17

    对于我这个“大白”来讲，有点不太懂，但图表很美观，一定效果不错。joy

    Reply View the author
    琴软
    deepin
    2023-02-24 02:46
    #18

    applaud

    Reply View the author
    wcs4221
    deepin
    2023-02-24 04:32
    #19

    tail

    Reply View the author
    Fredoong
    deepin
    2023-02-26 01:25
    #20

    改动得挺好的，我之前想编辑wiki，结果大家把东西放的乱七八糟，我根本不知道我写的东西应该放在哪个地方，所以我直接放弃了编辑wiki。

    Reply View the author
    1 / 2
    To page