documentation

44熱度

5回答

就是這樣。如果你想記錄一個函數或一個類，你可以在該定義之後加一個字符串。例如： def foo(): """This function does nothing.""" pass 但是模塊呢？我如何記錄file.py的功能？

14熱度

6回答

是否有一種簡單的方法從Visual Studio XML輸出生成MSDN樣式的文檔？我並不耐心爲它設置好的xslt，因爲我知道我不是第一個穿越這座橋的人。而且，我想最近設立沙塔，但它真的讓我的目光交錯。要麼我在這個過程中失去了一些重要的東西，要麼就是太牽扯其中。我知道有人有一個非常簡單的解決方案。，因爲我覺得我的格式製作的那款非邀請閱讀我在這裏重申：我給沙塔一試，但有一個很艱難的時期得到

17熱度

13回答

讓開發人員使用wiki

我在一個複雜的應用程序上工作，其中不同的團隊在自己的模塊上進行一定程度的重疊。前一段時間，我們設置了一個Mediawiki實例，部分是在我的提示下。我很難讓人們真正使用它，更不用說貢獻。我可以在共享信息中看到很多好處。它至少可以減少我們重新發明車輪的時間。該wiki的結構不是很好，但我不確定這是一個問題，只要你可以搜索你需要的東西。任何提示？

31熱度

6回答

Javadoc模板生成器

我有一個沒有Javadoc的大型代碼庫，我想運行一個程序來編寫一個基本的Javadoc信息（例如，爲每個方法的參數寫@參數...），所以我只需要填補剩下的空白。任何人都知道這個很好的解決方案？編輯： JAutodoc就是我一直在尋找。它具有Ant任務，一個Eclipse插件，並使用Velocity作爲模板定義。