[teiid-issues] [JBoss JIRA] (TEIIDSB-27) Created targeted documentation
Steven Hawkins (Jira)
issues at jboss.org
Mon Dec 16 09:40:38 EST 2019
[ https://issues.redhat.com/browse/TEIIDSB-27?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Steven Hawkins updated TEIIDSB-27:
----------------------------------
Fix Version/s: 1.3.1
1.3.1
(was: 1.3.0)
> Created targeted documentation
> ------------------------------
>
> Key: TEIIDSB-27
> URL: https://issues.redhat.com/browse/TEIIDSB-27
> Project: Teiid Spring Boot
> Issue Type: Task
> Components: documentation
> Reporter: Steven Hawkins
> Assignee: Steven Hawkins
> Priority: Major
> Fix For: 1.3.1
>
>
> It's expected that all developer oriented aspects will be self documented with javadoc and examples (udfs, pom options, configuration, custom extensions, etc.). However the Teiid ddl, sql - and in particular the presentation of topics that were presented separately such as data roles - need to be covered by documentation that does not reference topics such as Designer, wildfly/cli, xml vdbs, etc. We should probably also discuss if it makes any sense to still offer the local adminapi.
> We expect to receive some input from the documentation group around doc structure and strategies for generating specific documentation sets off of a master. At a high level we have:
> Administrator’s Guide - WildFly specific and should mostly be replaced by examples
> Caching Guide - References adminapi, Teiid JDBC, xml vdbs..
> Client Developer’s Guide - Teiid JDBC
> Developer’s Guide - References WildFly and several arche-types are specific to WildFly/JEE - should mostly be replaced by examples
> Embedded Guide - Should mostly be replaced by examples
> Reference Guide - References XML vdbs
> Security Guide - WildFly specific and should mostly be replaced by examples, but a lot is TDB
--
This message was sent by Atlassian Jira
(v7.13.8#713008)
More information about the teiid-issues
mailing list