star7th / showdoc

ShowDoc is a tool greatly applicable for an IT team to share documents online一个非常适合IT团队的在线API文档、技术文档工具
https://www.showdoc.com.cn
Other
12.09k stars 2.18k forks source link
api document documentation-tool showdoc

# ShowDoc

点击查看中文版教程

What is ShowDoc?

When we take over a module or project which has been developed by others, we always feel crazy watching at the codes without notes or comments.

Where is the document?! Where is the document?! Show me the doc!!

Programmers often want others to write technical documents, but not by themselves. Writing technical documents need lots of time and works, such as it needs to consider how to handle the format and layout of the documents. Beside, the man who writes the documents has to think all kinds of non-technical details. For example, which catalog should to be put in the newly-established word document.

In general, all kinds of the word documents are dispersively maintained by different people in a team.

How to get the latest documents? Here is a way.

The man gets the documents by shouting out, Lol. Then he will receive them from others through IMs or E-mail. This kind of communication is not so bad, but this is not the most effective way.

So, what is the most effective way? ShowDoc comes out!

ShowDoc is a tool greatly applicable for an IT team to share documents online. It can promote communication efficiency between members of a team.

What can it be used for?

With the development of mobile Internet, BaaS (Backend as a Service) becomes more and more popular. The server side(backend) provides API, and the APP side or Webpage frontend can conveniently invoke data through the backend. Using ShowDoc can compile exquisite API documents in a very fast and convenient way.

A good Data Dictionary, such as database structure can be easily exhibited to others, shown the definition of each field of the database structure.

You can absolutely use ShowDoc to write instructions of some tools, or some technical specifications explanation documents for the team to query.

What functions does it have now?

Responsive webpage design can share the project documents to computer or mobile devices for reading. It can also export the project into offline word document.

Deploy it on your own server

About the copyright

ShowDoc is issued complying with Apache2 Open Source License, and it is free. Showdoc has an additional copyright notice on compliance with the Apache2 Open Source License: Showdoc official And author star7th Have the copyright and corresponding rights of the program, On the premise of retaining the copyright information and links on the program UI interface, it can be used for free or secondary development If you need to change copyright information or copyright links, you need to obtain official consent and authorization.