Differences

This shows you the differences between two versions of the page.

--- en:dev:howto:module [2016/05/30 23:54] – no code available - no modules writeable yet. admin
+++ en:dev:howto:module [2017/10/16 13:22] (current) – typo nerdoc
@@ Line 1: / Line 1: @@
-{{tag>stub}}
 ====== How to write a new module ======
@@ Line 9: / Line 8: @@
   * Every module should provide information about dependencies to other modules, a detailed (technical) description what is the **purpose** of the module, which  **responsibilities** it has and how it is **structured**.
-  * Every module has a separate ''draft'' page, where considerations and software design happens in the first place. For e.g. the core module this is [[en:dev:modules:core:draft|en:dev:modules:core:draft]].
+  * Every module has a ''draft'' page, where considerations and software design happens in the first place. For e.g. the core module this is [[en:dev:modules:core:draft|en:dev:modules:core:draft]].
   * A ''spec'' link should point to a page where all the technical information is assembled, everything you need to understand the module.
-  * The page should also contain a link to the API of the module, which should be available automatically after the code is properly documented using sphinx/epydoc (TODO).
+  * The page should also contain a link to the API of the module, which should be available automatically after the code is properly documented using sphinx/epydoc.
+FIXME Maybe Spec/API should be together, using Sphinx...
 If you set up a new module page (by creating the new page ''en:dev:modules:mymodule''), it is created using a template and prefilled with the above links as far as possible. The ''stub'' tag is automatically applied to the new page to indicate that it is far from complete. If you have completed the page, please remove the ''stub'' tag from the page.