更新多处官方文档入口与版本说明 by QinIndexCode · Pull Request #1045 · jaywcjlove/reference

QinIndexCode · 2026-06-17T09:14:02Z

Summary

更新 FastAPI、Flutter、Docker Compose、jq、Less、Scala、Emoji、Gemini CLI、Ruby、React 共 10 处文档的官方入口或版本说明
调整 Docker Compose、FastAPI、Flutter 等示例，使安装、版本检查和参考链接说明更清晰
补充 FastAPI release notes、Docker Compose standalone install、Ruby 3.4 API、React StrictMode、Flutter SDK archive 等官方参考

References

FastAPI official docs and release notes
Flutter install docs and SDK archive
Docker Compose plugin install docs and releases
jq official site and manual
Less.js official docs
Scala official docs and API
Unicode Emoji v17 charts
Google Gemini CLI repository and Google Cloud docs
Ruby official docs and Ruby 3.4 API
React StrictMode docs

Validation

npx --yes markdownlint-cli docs\fastapi.md docs\flutter.md docs\docker-compose.md docs\jq.md docs\lessjs.md docs\scala.md docs\emoji.md docs\gemini-cli.md docs\ruby.md docs\react.md
git diff --check
npm.cmd run build

jaywcjlove · 2026-06-17T12:12:44Z


 ```sh
 docker compose version
-# Docker Compose version v2.17.3


@QinIndexCode 这里是输出结果

已恢复这段 docker compose version 的输出结果，保留为示例输出格式。

jaywcjlove · 2026-06-17T12:13:22Z


 docker version
 # Client: Docker Engine - Community
-# Cloud integration: v1.0.31


@QinIndexCode 这里是我真实的输出结果

已恢复 docker version 中 Cloud integration、Version、API version 这些真实输出行。

jaywcjlove · 2026-06-17T12:14:25Z

 ```sh
-curl -SL https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
+DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
+mkdir -p $DOCKER_CONFIG/cli-plugins


@QinIndexCode 需要简单安装并加以说明

已改为简单的 standalone 安装示例，并补充说明该方式用于兼容旧项目中的 docker-compose 命令，版本号可按 Compose releases 替换。

jaywcjlove · 2026-06-17T12:15:33Z


 ```sh
-$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
+$ sudo ln -s $DOCKER_CONFIG/cli-plugins/docker-compose /usr/local/bin/docker-compose


默认 $DOCKER_CONFIG 这个环境变量是空的

已去掉依赖 $DOCKER_CONFIG 的写法，软链接示例恢复为 /usr/local/bin/docker-compose 到 /usr/bin/docker-compose。

jaywcjlove · 2026-06-17T12:16:50Z

 ```

-Python: `3.9.5` FastAPI: `0.103.1`
+建议使用当前受支持的 Python 版本，并通过 `python -m pip show fastapi` 确认本地安装版本。


@QinIndexCode 我希望描述简单，如果是命令可以放到命令中如

$ uvicorn main:app --reload $ python -m pip show fastapi #确认本地安装版本

尽量简单

已按建议简化，把 python -m pip show fastapi 放进命令块，并移除了单独描述。

jaywcjlove · 2026-06-17T12:18:02Z

    ```bash
    $ cd ~/development
-    $ unzip ~/Downloads/flutter_macos_3.22.2-stable.zip
+    $ unzip ~/Downloads/flutter_macos_*_stable.zip


@QinIndexCode 希望的是固定版本安装

已改回固定版本安装示例，更新为当前官方 archive 中的 stable 版本 3.44.0，并保留 SDK archive 作为其他版本入口。

jaywcjlove · 2026-06-17T13:51:34Z


 - [CSS 备忘清单](./css.md) _(jaywcjlove.github.io)_
- [在线编译预览](http://lesscss.org/less-preview/#eyJjb2RlIjoiI2xpYigpIHtcbiAgICAuY29sb3JzKCkge1xuICAgICAgQHByaW1hcnk6IGJsdWU7XG4gICAgICBAc2Vjb25kYXJ5OiBncmVlbjtcbiAgICB9XG4gICAgLnJ1bGVzKEBzaXplKSB7XG4gICAgICBib3JkZXI6IEBzaXplIHNvbGlkIHdoaXRlO1xuICAgIH1cbiAgfVxuICBcbiAgLmJveCB3aGVuICgjbGliLmNvbG9yc1tAcHJpbWFyeV0gPSBibHVlKSB7XG4gICAgd2lkdGg6IDEwMHB4O1xuICAgIGhlaWdodDogKCR3aWR0aCAvIDIpO1xuICB9XG4gIFxuICAuYmFyOmV4dGVuZCguYm94KSB7XG4gICAgQG1lZGlhIChtaW4td2lkdGg6IDYwMHB4KSB7XG4gICAgICB3aWR0aDogMjAwcHg7XG4gICAgICAjbGliLnJ1bGVzKDFweCk7XG4gICAgfVxuICB9IiwiYWN0aXZlVmVyc2lvbiI6IjQueCJ9) _(lesscss.org)_
+- [Less.js 官方文档](https://lesscss.org/) _(lesscss.org)_


@QinIndexCode 在线编译预览是个工具，你可以添加个官方文档

已恢复“在线编译预览”工具链接，同时额外添加 Less.js 官方文档入口。

jaywcjlove · 2026-06-17T13:52:41Z

- [检测意外的副作用](https://zh-hans.reactjs.org/docs/strict-mode.html#detecting-unexpected-side-effects)
- [检测过时的 context API](https://zh-hans.reactjs.org/docs/strict-mode.html#detecting-legacy-context-api)
- [确保可复用的状态](https://zh-hans.reactjs.org/docs/strict-mode.html#ensuring-reusable-state)
+- 重新渲染组件以发现不纯渲染


@QinIndexCode 为什么删除了链接地址？

已恢复 StrictMode 相关列表链接，并保留新的 react.dev StrictMode 参考入口。

jaywcjlove · 2026-06-17T13:53:38Z

 ===

-渐进式 JavaScript 框架 [Vue 2](https://v2.cn.vuejs.org/) 备忘清单的快速参考列表，包含常用 API 和示例。
+渐进式 JavaScript 框架 [Vue 2](https://v2.vuejs.org/) 备忘清单的快速参考列表，包含常用 API 和示例。Vue 2 已于 2023 年 12 月 31 日结束官方维护，新项目建议使用 Vue 3。


@QinIndexCode 这是 vue2 的速查手册，不需要说明什么，比如什么时候不维护

已撤回 Vue 2 EOL/不维护说明，恢复为原来的 Vue 2 速查手册描述。

jaywcjlove · 2026-06-17T13:54:21Z

 <!--rehype:className=style-round-->

-注意：Vue 2.x 版本对应 Vue Router 3.x 路由版本
+注意：Vue 2.x 版本对应 Vue Router 3.x 路由版本；维护旧项目时应同步评估迁移 Vue 3。


不需要说明苹果迁移的问题，因为这是一分 vue 2 的速查手册

已删除迁移建议，恢复为“Vue 2.x 版本对应 Vue Router 3.x 路由版本”的简洁说明。

jaywcjlove reviewed Jun 17, 2026

View reviewed changes

docs: refresh official references

09e6490

QinIndexCode force-pushed the docs/refresh-official-references branch from b526055 to 09e6490 Compare June 18, 2026 01:02

Uh oh!

Conversation

QinIndexCode commented Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

References

Validation

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

QinIndexCode commented Jun 17, 2026 •

edited

Loading