Hi, I was hitted by old documentation for our UI bindings which currently we cannot update and use version from opensuse 11.3(!!!). So I decide to do something with it. Goals are to NIH as much as possible and to be automatically updated. Result is at [1]. Currently old documentation is written in combination of yastdoc ( looks like javadoc or doxygen documentation ) and docbook. Currently I focus only yastdoc part. It is a lot of documentation, so I decide to just tune a bit doxygen to understand it, even if result is not perfect. For publishing I use third party side that allows uploading of static pages called surge.sh, which have travis integration, so travis after passing all test and after merge of pull request will publish new version of documentation. Advantage is also easy local run, just run `rake doc` and it will do everything for you. What is currently missing and would be nice: - linking from yast.github.io ( maybe keep both old and new link, as old have also also docbook info and nicer UI now ) - modified style ( nicer css, modified header and footer, etc ) - adapt documentation ( add pictures, some title for examples, for widgets make header of arguments, convert some old ycp code and so on ). - nicer initial page with more info - convert and update content of old docbook documentation to markdown I will welcome any help or comments. Josef [1] http://yast-ui-bindings.surge.sh/ -- To unsubscribe, e-mail: yast-devel+unsubscribe@opensuse.org To contact the owner, e-mail: yast-devel+owner@opensuse.org