创建或贡献入门指南比以往任何时候都更容易。

工程 | Greg L. Turnquist | 2014年1月23日 | ...

Spring 社区的朋友们!

我们不断收到反馈,Spring 的入门指南大受欢迎。

到目前为止,我们已将这些指南迁移到Asciidoctor。我们的指南也已扩展到包括面向客户端的指南。更多内容即将推出!

使这些指南能够长期有效性的最后一个环节是每个指南侧边栏中的导航链接。我们现在正在使用元数据将各种指南相互标记和链接,同时还将它们与相关项目连接起来。

例如,如果你访问《使用 AngularJS 消费 RESTful Web 服务》,你将看到一个侧边栏,其中包含

  • 指向该指南顶级部分的快捷方式
  • 两个标签:restJavaScript,允许你搜索包含相同标签的其他指南的链接
  • 指向Spring Framework项目的链接,因为本指南专注于将 Spring MVC 与 AngularJS 结合使用
  • 指向了解 REST了解 JSON 的链接

侧边栏现在无需维护。

注意:如果有什么是我喜欢的,那就是零维护!

如果您正在为我们的某个指南做贡献,您将不再需要编辑关于侧边栏的单独文件。相反,每个指南的顶部都用标签项目元数据进行标记。仅此而已,就可以构建侧边栏上的导航链接。

这使得发布一批新的相关指南比以往任何时候都更容易,这些指南通过一些相互链接串联起来。另一个例子,可以查看所有Spring Data 指南

当您访问指南列表时,您可以根据标题和指南描述以及标签即时搜索。正如您从上面的所有链接中看到的,搜索条件可以被加入书签、捕获和保存。

请注意:标签数据可能会发生变化,所以不要想当然地认为它会永远不变。

随着指南创建和管理方式的更新,创建新指南或编辑现有指南的过程比以往任何时候都更简单。

如果您有新指南的想法,可以在您自己的 GitHub 存储库中进行开发。请务必查看我们的模板项目以及编写指南,以了解编写、编辑和贡献的过程。

我们期待看到您的贡献,并将积极宣传,以便各个 Spring 负责人也能为他们的项目编写更多指南。

获取 Spring 新闻通讯

通过 Spring 新闻通讯保持联系

订阅

领先一步

VMware 提供培训和认证,助您加速进步。

了解更多

获得支持

Tanzu Spring 提供 OpenJDK™、Spring 和 Apache Tomcat® 的支持和二进制文件,只需一份简单的订阅。

了解更多

即将举行的活动

查看 Spring 社区所有即将举行的活动。

查看所有