<html> <head> <meta content="text/html; charset=UTF-8" http-equiv="Content-Type"> </head> <body bgcolor="#FFFFFF" text="#000000"> Hi all, As our project and team grows and more external people (not only QA) is trying out our project, I miss some reasonable documentation more and more. And if there is some it's spread across several places, which is not very usable. Therefore I would like to know your opinion on improving this status. One possible improvement could be creating a wiki page (or editing existing one) after each story finished. On this page there could be information such as: <ol> <li>the story itself (or more stories in case they relate together)</li> <li>some background description with important information and links to external sources.</li> <li>info about a keyword that can be used for searching commits related to this story</li> <li>simple scenario describing how to use the feature developed with this story (useful not only for QA)</li> </ol> I've created one such a page after finishing my last story about revoking entitlement certificates (it can be found under DevelopmentResources -> Features: <a class="moz-txt-link-freetext" href="https://fedorahosted.org/katello/wiki/EntitlementsRevocation">https://fedorahosted.org/katello/wiki/EntitlementsRevocation</a> What do you think about this movement? -- Ivan </body> </html>