怎样建设凡科网站,网站选服务器文件,苏州诗华洛网站建设,o2o商城网站搭建本文系 NebulaGraph Community Academic 技术文档工程师 Abby 的参会观感#xff0c;讲述了她在中国技术传播大会分享的收获以及感悟。 据说#xff0c;技术内容领域、传播领域的专家和决策者们会在中国技术传播大会「tcworld China 2022」大会上分享心得。作为一名技术文档工… 本文系 NebulaGraph Community Academic 技术文档工程师 Abby 的参会观感讲述了她在中国技术传播大会分享的收获以及感悟。 据说技术内容领域、传播领域的专家和决策者们会在中国技术传播大会「tcworld China 2022」大会上分享心得。作为一名技术文档工程师本着了解相关行业的发展趋势和提升自我为 NebulaGraph 社区创造更大价值的心态参加了此次大会。 第一次参加 tcworld China 技术传播大会干货挺多记录一下参会的收获和感受。
tc技术内容全称 technical content。既然是技术内容那么技术内容是如何进行传播呢
初看会觉得技术传播和作为内容生产者的技术文档工程师或资料开发没有半毛钱关系。然而是本人坐井观天了全场听下来许多课程主题涉及“从内容到营销”当中不乏营销常出现的词汇——“故事传播”、“内容运营”、“视频传播”等等。即便是针对产品编写的说明书也是需要考虑用户和其使用场景这正是传播的逻辑。除了涉及“从内容到营销”主题大会还分享了文档呈现及编辑器的演进和发展、文档工程师的价值等主题内容。
下面由我带大家回顾一下这次的技术传播学习之旅。
课程主题
听了技术传播大会的大部分课程从「技术文档工程师的价值」到「如何传播运营技术内容中的各个环节」本次大会都有对应的课程主题。大会课程主题可以形成一条链路 注TW全称 Technical Writer即技术文档工程师。
干货及思考
大会中对技术文档工程师的价值、文档内容编辑方式、呈现方式、运营方式的现状及发展趋势做了相应的分享。在这过程中我也收获了一些新知识和有了自己的一些思考。
技术文档工程师的价值
首先技术文档工程师是什么引用百科中的一句话———“文档工程师是指协同开发人员收集资料安排开发计划编写企业项目开发所需的各类文档同时保证文档的质量、安全等的技术人员他们肩负着软件开发过程中信息处理与整合的重要职责。面对“文档”他们需要完成包括安排开发计划、制定各类模板、跟踪编写进度以及编辑管理等在内的一系列工作实现文档处理的“一条龙”服务。”
有人可能会说技术文档工程师就是给产品 / 项目编写文档的人员。这也就延伸出来一个现象文档工程师的价值经常被挑战。有些老板甚至文档工程师自身会想为什么企业不训练一个开发工程师来直接写技术文档呢这样他对技术的理解还会更强。为什么还要设立这样的专职的岗位
首先这样的技术人员不太好找具有技术文档编写能力的技术人大多都希望深耕自身的技术领域而不愿意去写这些对“硬”技能能力提升不多的内容。毕竟相较于文档更轻量的注释已经够让技术人头疼了。另外就是专业的技术文档所呈现的内容无论是可读性还是对产品的理解会比其他人写出来的更好、更贴近用户。目前全球许多大企业都在大量聘用技术文档工程师像海康、阿里都有几十人的技术文档团队人力不足的时候还需要外包。企业愿意付出这样的成本去招聘相关人才就证明了技术文档工程师有其独特的价值存在。
这也是为什么会专门存在这样的部门。因为之前未设立技术文档部门时其他人来写这块内容呈现的效果非常差、用户体验不佳。因此很多企业才会存在技术文档这个部门来帮助企业解决人员分工问题。假如一个企业里的技术人员既要写东西还要去做技术或是去设计产品就会出现超级节点。那么分工的出现就解决这一痛点专门的人才从事文档编写专门的人才来搞技术这样才能把分工内的东西做精做好。
如何提升文档团队的影响力
作为文档工程师首先需要肯定和提升自己的认知维度提升文档团队的影响力具体怎么做参考下列方式
打破角色固化的认知拒绝做边缘人。文档角色只能输出内容吗不止是这样文档可以发现 bug、了解和分析用户需求、给产品设计提需求及意见。有意识地训练产品思维保持对产品的好奇心和敏感度。多接触真实的用户去现场给用户培训更好地了解用户实际使用产品中遇到的问题减轻用户的学习成本。像是 NebulaGraph 这类开源产品会经常查看社区用户常提到的问题并将该问题和解决方案写在文档中。学习用户体验法则、尼尔森的十大可用性原则利用「用户旅程地图」发掘机会点 。从用户痛点出发提出问题并给出初步解决方案和产品交互进行沟通并推动提升用户体验从而提升文档团队的影响力。
招聘和培养英文技术文档
如果技术内容传播还泛指国际上的传播那么英文技术文档对于产品的国际化具有关键作用。tcworld China 2022 分享中提到在进行英文技术写作人员招聘过程中常常遇到三个问题英文能力不足、技术能力不足、写作能力不足。
当急需人才、短期内又招不到人的情况下企业可以转变思维对英文技术翻译人员进行培训。在语言和写作方面英文技术翻译人员上手会相对较快。剩下的就是对其技术方面的专门培训。像是英文技术文档这种人群的招聘前提也是需要 ta 们具有很强的学习意愿和能力。
文档未来
听完全场我更喜欢 RWS 呼延韶文老师分享的《文档未来》课程他从内容的创作方式和内容的应用端两个方面分享了文档的发展趋势。
内容创作方式
文档的创造方式已经从最初的纸质版转为电子版Word / PDF的方式交付。文档正从纸质转变为电子再转变成数字化。文档数字化指文档内容模块化、结构化、文档生产流程的云化、文档和用户的可交互性。《文档未来》提到 Forrester 预测文档下一个十年新型基于云端、数据驱动、结构化的文档创作方式将成为主流。基于结构化、模块化主题内容还可做到文档内容的自动组合、更新自动推送等等。文档内容呈现的发展的最后阶段是交互性内容用户可以和内容进行交互多以 HTML CSS 实现。与技术的互动从文本到交互界面是由产品设计引发的潜意识过程所引导的。技术传播者越是了解这种心理过程越能创造出互动强的文档。
不仅仅《文档未来》提到了文档内容的模块化、结构化其他的课程《让技术文档智能化交付多场景呈现》、《如何构建知识百科并营销共建产业生态》也都提到了文档内容的模块化和结构化。结构化的主题内容可以一源多用并多格式发布。相对传统的编辑方式结构化能起到降本增效的作用。这种结构化、模块化的内容呈现是基于 XML 的体系结构比较火热且流行的标准是 DITA 标准。目前NebulaGraph 技术文档团队正在使用开源的文档编辑软件 MkDocs Material参考延伸阅读满足目前的内容复用需求。随着文档内容量不断增多后续可以考虑使用结构化、模块化的编辑软件创作文档内容。
内容应用端
文档内容发布后用户需要在门户网站浏览文档内容。那么如何呈现内容或者说如何组合内容以提升用户体验呢这个部分的内容和后面《开源网站信息架构的攻守之道》提到的信息架构有相似之处。在应用端文档网站可以做的用来提升用户体验的事情
语义化的搜索能力搜索引擎可以根据用户的使用场景搜索词语的意思检索到目标内容。知识模块化基于 XML 体系的内容发布。智能内容智能机器人可以推送用户搜索的问题。考虑用户常搜索的关键字考虑 SEO 创作内容。
信息架构 IA
在参加这次技术传播大会之前我只是知道 IAInformation Architecture这个词比较火但不懂什么是真正的信息架构。信息架构是什么用途是啥参加了大会后大概知道了 IA 的概念但是还是有点模糊具体是 IA 是做什么于是在网上找到了一篇浅显易懂的《如何进行信息架构设计》。下文仅列举相关概念。
什么是信息架构
信息架构信息架构
信息包括各种文本、图片、影音等元素架构则对应这些元素的选择、分类、导航和检索。
通俗点说信息架构就是通过合理的组织和表达各种信息元素让用户获取并理解信息更容易。为信息与用户认知之间搭建⼀座畅通的桥梁。
为什么需要信息架构
简言之引用《通过智能内容提供出色的客户体验》课程中的提到的一张图片如下图我们可以直观的看出知识点的不同排列组合与连接是提升体验的关键。那么如何来排列和连接这些知识就需要用到信息架构中的构建方式、类型及设计逻辑。 信息架构的构建方式
自上而下、自下而上和综合运用
1.自上而下的构建方式
自上而下的构建方式是由战略层驱动的根据产品目标与用户需求直接进行结构设计进行新产品规划或者产品重新定义的时候会用到。 自上而下的构建方式会先从最广泛的最有可能满足目标的内容及功能开始分类再依据逻辑细分次级分类。MVP 的设计思路所有分类都是空槽最后将内容和功能按顺序填入。它有一个明显的缺点是可能导致现有重要内容被忽略。
2.自下而上的构建方式
自下而上的构建方式是由范围层驱动的根据对现有的内容和功能需求的分析进行设计这是项目实践中大家最常用的一种方式。 在具体项目实践中产品或设计师根据对现有内容和功能需求的分析将它们分别归属到较高一级的类别从而逐渐构建出能反映我们的产品目标和用户需求的结构。常用卡片分类法辅助它也有一个缺点可能导致不能灵活兼容未来内容变动或增加。
3.综合运用的构建方式
正因为自上而下和自下而上都有其明显的缺点所以理想的信息架构的构建方式都是综合运用的同时从战略层和范围层进行驱动以构建一个适应性强的系统。 一个适应性强的信息架构系统能把新内容作为现有结构的一部分容纳进来如图左侧也可以把新内容当成一个完整的部分加入如图右侧。
信息架构的基本单位是节点节点可对应任意信息要素或信息要素的组合小到一个字段 / 控件大到一个界面 / 功能都是可以的。不同场景下节点的颗粒度不相同。
这些节点的排列方式有 4 种常见的类型也就是我们所说的信息架构类型。
常见的信息架构类型
常见信息架构有 4 种层级结构、矩阵结构、自然结构和线性结构。
1.层级结构
又叫树状结构或中心辐射结构。 2.矩阵结构
矩阵结构允许用户沿着两 / 多个维度在节点之间移动最终都可以帮助用户找到想要的信息。 3.自然结构
自然结构不遵循任何一致的模式。节点被逐一连接起来节点与节点之间有联系但没有分类。 4.线性结构
在线性结构中用户不能进行跳转只能一步一步按顺序浏览对应的信息 。 信息架构的逻辑呈现的 5 个过程 内容运营
数字时代媒介演变正在降低信息传播的成本和难度。很多技术内容正在通过短视频、问答、直播等形式传播让受众有机会了解到更多有价值信息学习到更多的新知识。
除了常规的数据分析、SEO 以外我对内容运营这块印象最深的是有 3 个课程专门分享通过视频进行技术传播。有个课程分析目前国内有两个视频传播火热的视频平台抖音和 B 站。
B 站中知识类内容的视频较多抖音视频主要以生活休闲类为主。除了题材之外B 站的视频基本上为中长视频抖音视频以短视频为主。所以技术类内容因为时长、偏知识题材的原因视频传播更适合放在 B 站上。
B 站中播放量较多的视频特征内容硬核、专业的授课老师、趣味性高、与热点结合。
对于制作视频本身了解到一些视频制作的工具 还有印象较深的是制作 VTuber 视频以虚拟人物形象在网路影片平台上传影片或进行直播的创作者。 如果不想露真人但又想有人物动作的时候可以考虑制作 VTuber 视频进行。
课程笔记
除了一些因时间冲突没参加外参加的大部分课程名称及分析概参考。 延伸阅读
如何打造多版本文档中心 谢谢你读完本文 (///▽///)
NebulaGraph DesktopWindows 和 macOS 用户安装图数据库的绿色通道10s 拉起搞定海量数据的图服务。通道传送门http://c.nxw.so/9Rs1u
想看源码的小伙伴可以前往 GitHub 阅读、使用、(з)-☆ star 它 - GitHub和其他的 NebulaGraph 用户一起交流图数据库技术和应用技能留下「你的名片」一起玩耍呢~
