3作者: ivarojha9 个月前
我所有的开发文档分散在 Notion、Google Drive、一个 Github 仓库和 Slack 里的文本笔记中。我最近在招聘开发人员,觉得应该先整理一下这些文档。 我需要一个地方,可以保存开发人员入职指南、设计文档、API 文档、运维相关内容、应急手册,最好还能连接 Github 进行代码搜索,连接 Linear 以及其他常用的开发工具。而且,维护和同步这些文档应该非常轻松。 根据我之前在初创公司的经验,我们用过 Confluence 和 Phabricator。现在有什么新的东西是初创公司常用的吗?
6作者: ruben-davia9 个月前
我一直在开发一个名为 Davia 的项目——一个用于创建交互式文档的平台。 这些是“活文档”:每一页都是独立的,结合了可编辑内容、交互式组件和数据。你可以阅读、编辑并真正地与它们互动——更像是迷你应用,而不是静态文档。 以下是它的有趣之处: 交互式组件是即时生成的代码片段,因此你不会像在 Notion 中那样受限于固定的块。你可以在文档中创建无限灵活的功能。 从技术上讲,一个交互式页面由组件(MDX 文件)、数据(JSON 文件)和一个主 HTML 文件组成——所有这些都是即时捆绑和编译的。这使得每个文档都拥有自己的可移植架构。 构建完成后,你可以将你的文档发布为实时网站(具有自定义 URL 和持久交互)或作为开源模板,供其他人导入、混音和在此基础上构建。 我们正在围绕这个项目建立一个开源社区。如果人们导入你的模板,你将获得署名(在测试版中,你甚至可以从中获利)。 在测试期间,它是免费使用的,我很乐意与你一起构建它。 如果你喜欢摆弄小工具、突破交互式文档的极限,或者想探索新的知识分享方式,这可能会很有趣。 欢迎提供反馈、想法和贡献——加入我们 r/davia_ai!
2作者: kmelve9 个月前
嘿,HN!在 styled-components 进入维护模式后,我们对其进行了 fork,因为我们的生产应用(以及许多其他应用)无法在一夜之间完成迁移。 背景:我们在 2024 年 7 月向 styled-components 提交了 PR #4332 (<a href="https:&#x2F;&#x2F;github.com&#x2F;styled-components&#x2F;styled-components&#x2F;pull&#x2F;4332" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;styled-components&#x2F;styled-components&#x2F;pull&#x2F;...</a>),其中包含了 React 18 的优化。当维护模式宣布后,我们将该 PR 变成了这个 fork。 我们修复了什么: * 添加了 React 18 的 useInsertionEffect * 重写了 React 19 的流式 SSR * 用现代 JS 替换了 ES5 输出 * 使用原生 flatMap 优化了数组操作 * 修复了 Next.js App Router,使其无需 50 多行样板代码即可运行 Linear 进行了测试,发现在没有代码更改的情况下,初始渲染速度提高了 40%。 如何尝试: ```bash npm install @sanity/styled-components@npm:styled-components ``` 或者对于 React 19: ```bash npm install @sanity/css-in-js@npm:styled-components ``` 用于自行测试的基准测试工具:<a href="https:&#x2F;&#x2F;css-in-js-benchmarks.sanity.dev&#x2F;" rel="nofollow">https:&#x2F;&#x2F;css-in-js-benchmarks.sanity.dev&#x2F;</a> 我们将其命名为“last-resort”(最后的手段),因为它确实如此。我们并不打算长期维护 styled-components - 我们实际上正在迁移到 vanilla-extract。这只是一个性能桥梁,供团队进行适当的迁移。 React 团队建议放弃运行时 CSS 注入。我们同意。但迁移需要时间,而生产应用需要立即发布。