問題描述

我是一個新手，以前從來沒有發(fā)布過python程序。最近老師讓我寫了兩個python小模塊，一個是將pdf轉(zhuǎn)為txt,另一個是計算轉(zhuǎn)好的txt文檔的相似度。我寫好了并且也知道如何打包成第三方庫，但是不知道配套的文檔應(yīng)該怎么寫？我在網(wǎng)上也查了一下，有的人說’’’注釋里的內(nèi)容就是文檔（這個注釋我都認(rèn)真寫了），但是不知道是不是還要在包里放一個txt文件，寫一寫不同模塊不同函數(shù)的用法，還是怎么樣？謝謝各位了，我真的是不知道這個文檔咋搞...

問題解答

sphinx

我猜你也用過git，類似于git project中的readme 文件，看兩個開源項目是怎么寫的，寫readme的目的，大概就是幫助別人知道這個項目是什么，能干什么，如何使用，注意要點，差不多就醬

模塊.py

’’’這是模塊文檔’’’pass

>>> import 模塊>>> help(模塊)Help on module 模塊:NAME 模塊 - 這是模塊文檔FILE d:python34模塊.py>>>