[ https://issues.jboss.org/browse/JBIDE-18846?page=com.atlassian.jira.plugi... ] Nick Boldt commented on JBIDE-18846: ------------------------------------ Devdoc is now merged. Spoke with [~rob.stryker] and here's some feedback on the above prototype: 1. Re: *Maturity* column {quote} i would prefer you use words that have been defined, yes. So supported / tested / techpreview / exper / ea is fine if you link to this document [1]{quote} [1] https://devstudio.redhat.com/9.0/staging/updates/#central 2. Re: asciidoc markup or yaml? {quote}whichever is easier for you to keep updated. assuming both are equally difficult (change text somewhere) then i prefer asciidoc{quote} 3. Re: flowchart on [2] [2] http://download.jboss.org/jbosstools/builds/cascade/master.html ( http://download.jboss.org/jbosstools/builds/cascade/images/HowWeBuild_Dia... ) {quote} that image is useless. It's not small enough to be an effective thumbnail, and not large enough to read the text{quote} So... I'm going to flesh it out and fix the broken links (stuff moved because JBDS-3208 is now done). yaml is a good idea but then I have to go through the overhead of building, pushing to master, reviewing, pushing to production. This way we can just stick doc in jbosstools-devdoc. We rarely add a new project and going a glob F&R once a year to update links isn't a huge overhead compared to having to build yaml w/ rake. And there's nothing HTML5'y we need to do here, afaict, so plain ol' adoc should be fine. -- This message was sent by Atlassian JIRA (v6.3.15#6346)