Torna 1.24.0 released, interface documentation solution

Torna 1.24.0 is released. The content of this release is as follows:

【New】

  • Supports viewing document change records, accurate to the field level, and supports content comparison of Markdown and rich text documents.
  • Added pre-script and post-script to dynamically process parameter information before requesting
  • Added new document status fields (not started, in progress, completed), and supports DingTalk push when changing the status
  • Document content changes can be pushed to the DingTalk group and can be @someone
  • Support custom parameter types (drop-down box editable)

【repair】

  • Unread messages can only display 10 questions

The focus of this upgrade is to view the document change record. Click to view in the upper right corner of the document preview interface.

Pop up change history:

In addition, rich text documents and Markdown documents support content comparison

After the document content is changed, it can be pushed to the DingTalk group.

Version 1.24.0 adds request preprocessing, which can dynamically modify request parameters and other information, such as obtaining tokens and parameter encryption before requesting the interface.

For specific use, you can deploy Torna for experience~

About Torna

The interface document solution aims to make interface document management more convenient and faster. Torna uses team collaboration to manage and maintain interface documents, and incorporates different forms of documents into unified maintenance.

Torna makes up for the shortcomings of traditional document generation tools (such as swagger), enriching and enhancing some practical functions while maintaining the original functions.

 

Solve document management pain points

  • Not satisfied with the presentation of swagger document preview page and debugging page
  • I don’t like the intrusive annotations of swagger.
  • I hope to use javadoc comments to generate documentation and perform interface debugging
  • It is hoped that all project interface documents of the company can be managed uniformly.
  • I hope to provide several documents in the project to third-party callers for viewing
  • Hope that dictionary enumeration in the project can be managed uniformly

If you have the above needs and pain points, you may want to try using Torna

quick start

Recommended combination

smart-doc + Torna realizes the automation of the entire document process

If you use Java language, it is recommended to use smart-doc + Torna

smart-doc + Torna form an industry-leading document generation and management solution. Smart-doc is used to extract Java source code and comments to generate API documents without intrusion, and automatically push the documents to the Torna enterprise-level interface document management platform.

With this combination, you can push the interface information to the Torna platform just by writing Java annotations, thereby realizing interface preview and interface debugging.

The content pushed is:接口名称/author/Path参数/Header/请求参数/返回参数/字典列表/公共错误码

If you are using a non-Java language, you can use the form page to edit the above content. After completion, you can also preview and debug the interface.

smart-doc integrates Torna graphic tutorials

Guess you like

Origin www.oschina.net/news/267541/torna-1-24-0-released