潘智祥

发表于 Waline： 本文字数： 2k 阅读时长 ≈ 7 分钟
本文聚焦IT行业写文档问题，探讨如何让他人知晓文档、确保读者读懂、维护文档及判断文档必要性，分享了优化索引、创建客服系统等实用经验与方法。

不知道其他行业的工作中写文档是不是一个值得讨论的问题，但是在IT行业中，这绝对是一个值得好好讨论的问题。

在过往的工作的经历中，经常会遇到或者听到别人抱怨说某个系统或者API没有文档以致于很难甚至完全没办法接手工作的情况。
由于已经意识到这个问题，所以我自己在工作中会比较注意写文档这个事情，尽量把我觉得别人可能需要的了解的地方都写成文档，但发现还是有很多问题，今天写个笔记记录一下这些问题以及我的看法。

先直接说我观察到的问题，有以下几个：

发表于 Waline： 本文字数： 282 阅读时长 ≈ 1 分钟
本文源自Paul Graham的文章，讲述获得新想法的途径是关注反常现象，最好在知识边界寻找。知识边缘有很多裂隙，探索这些裂隙有望产生全新知识芽点。

原文地址：HOW TO GET NEW IDEAS
作者：Paul Graham
时间：2023-01

(有人把我的随笔用于训练GPT，以便根据这些文章获得一些答案。他问这个模型，好的想法从何而来，模型给出的答案还可以，但不是我想表达的，以下是我的回答。)

获得新想法的途径是关注反常现象：有哪些现象看起来是很奇怪的、有悬念的或者残缺的？你可以在日常生活中观察到反常现象（很多脱口秀就来源于此），但是寻找他们的最好的地方是知识的边界。

发表于 Waline： 本文字数： 1.8k 阅读时长 ≈ 6 分钟
本文介绍了SBOM（软件物料清单）的概念，类比为软件的配料清单。阐述其在美国因政府采购规定而热门，列举了它的9个作用，分析国内实用点，还提及实施前提和范围，包括应包含的信息。

SBOM是什么

SBOM全称是Software Bill of Materials, 中文是软件物料清单。

做个类比，可以把SBOM简单地理解为软件的配料清单，就像我们买雀巢的速溶咖啡的时候，外包装上会有的配料清单。

发表于 Waline： 本文字数： 961 阅读时长 ≈ 3 分钟
本笔记聚焦用Vue3搭建项目并与后端API互动，介绍为首页添加展示内容，包括静态与需从后端获取数据的展示，还展示了API修改及首页展示文件修改的代码。代码地址：[https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes](https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes)

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

在这篇笔记中，会为首页添加一些展示内容，分为两种类型，一种是静态展示，不用从后端获取任何数据；还要一种是要从后端获取数据后才能展示的。

发表于 Waline： 本文字数： 4k 阅读时长 ≈ 14 分钟
本系列笔记聚焦用Vue3搭建项目并与后端API互动，介绍登录功能实现，包括axios请求API封装、jwt在登录中的应用等，还给出代码地址，建议结合视频和仓库内容学习。

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

这篇笔记的内容有点难,建议多看几遍

发表于 Waline： 本文字数： 776 阅读时长 ≈ 3 分钟
本系列笔记聚焦用Vue3搭建项目并与后端API互动，不涉及Vue基础。介绍了用Django+DRF写的后端，详细讲解后端运行环境配置，包括安装Python、配置虚拟环境、运行项目及登录获取API等步骤。

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

配置后端运行环境

发表于 Waline： 本文字数： 1.5k 阅读时长 ≈ 5 分钟
本笔记聚焦利用Vue3搭建项目并与后端API互动，不涉及Vue基础。介绍完善页面路由，包括确定所需路由、修改配置、在Main.vue引用，还讲解为左侧菜单栏添加跳转函数，附代码示例。

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

完善页面路由

发表于 Waline： 本文字数： 888 阅读时长 ≈ 3 分钟
本系列笔记聚焦用Vue3搭建项目并与后端API互动，不涉及Vue基础。此篇介绍创建CommonHeader.vue组件，解释代码逻辑，还说明了在Main.vue中引用该组件的方法，附代码地址。

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

上一篇笔记我们记录了怎么实现左侧的公共菜单栏，这一篇讲一下怎么使用公共头部。

发表于 Waline： 本文字数： 1.7k 阅读时长 ≈ 6 分钟
本系列笔记聚焦用Vue3搭建项目并与后端API互动，介绍网站页面布局，包括左右分区及公共组件，还讲解Element Plus安装、引入，修改Vue3初始样式，实现布局，以及创建CommonAside组件等内容。

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

页面布局说明以及效果展示

发表于 Waline： 本文字数： 1.1k 阅读时长 ≈ 4 分钟
本文介绍如何利用Vue3搭建项目并与后端API互动，重点讲解vue-router的配置。包含vue-router的安装、路由配置代码创建、页面文件创建及与vue实例绑定等步骤，还给出代码示例及项目运行方法。代码地址：[https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes](https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes)

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

路由的简单介绍

0%