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

工程 | 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 社区中所有即将举行的活动。

查看全部