User Tools

Site Tools


devel:module-docbook-readme

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
devel:module-docbook-readme [2020/08/12 16:48]
miconda [Kamailio Style]
devel:module-docbook-readme [2020/08/12 16:52]
miconda [Writing Docbook Files for Module Readme]
Line 1: Line 1:
 ====== Writing Docbook Files for Module Readme ====== ====== Writing Docbook Files for Module Readme ======
  
-README file for each module is generated from xml docbook files residing in **doc/** sub folder. When one adds a new module it has to write these filesthen generate the README using:+README file for each module is generated from xml docbook files residing in **doc/** sub folder. The README file must not be changed directly, the editing has to be done to the xml docbook files. 
 + 
 +When one adds a new module it has to write these xml docbook files and then generate the first version of README using:
  
 <code> <code>
Line 7: Line 9:
 </code> </code>
  
-Note: after the new module has been published to the public git repositorydo not generate anymore the README for pushing it to git. Push only the changes to the xml files, because the README is automatically generated by a cron service running on project infrastructure to ensure coherent formatting and avoid conflicts of backporting to older branches. Of course, you can generate it locally to check if the results is the expected one, but then restore the old README without changes -- it can be done with:+For old modules (or after the new module has been published to the public git repositorydo not generate anymore the README for pushing it to git. Push only the changes to the xml files, because the README will be automatically generated by a cron service running on server to ensure coherent formatting and avoid conflicts when having to backport to older branches. 
 + 
 +Of course, you can generate the README locally to check if the result is the expected one, but then restore the old README without changes -- it can be done with:
  
 <code> <code>
devel/module-docbook-readme.txt · Last modified: 2020/08/12 16:52 by miconda