[jira] Commented: (OFBIZ-571) Move the various documentation pages to the OFBTECH space on docs.ofbiz.org

Posted by Nicolas Malin (Jira) on
URL: http://ofbiz.116.s1.nabble.com/jira-Created-OFBIZ-571-Move-the-various-documentation-pages-to-the-OFBTECH-space-on-docs-ofbiz-org-tp175787p175817.html


    [ http://issues.apache.org/jira/browse/OFBIZ-571?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12461640 ]

Jacques Le Roux commented on OFBIZ-571:
---------------------------------------

Scott,

I saw your work, quite impressive. Of course if we keep it there we will have to update it. For instance
. there is no more an    ofbiz/core/docs/xmldefs/ofbiz/simple-methods.dtd file (hence my comment just above).
.  env-to-field
   field-to-env
   string-to-field
   field-to-field
   env-to-env  are deprecated and no more used in OFBiz (see my comment above)

I thought a bit about that. IMHO it's better to have only one source of information (more reliable, because things change) and I finally agree with the ones that think that this source should be in XSD files. But for that we have to find an universal(?) tool usable by everyone. Even if we don't use it because we prefer our proper tool (Oxygen being a good but not free candidate here). If we can't find and recommend a tool like this it will be difficult for newbies to apprehend the minlang and such specif using XSD documentations.

My 2 cents ;o)

> Move the various documentation pages to the OFBTECH space on docs.ofbiz.org
> ---------------------------------------------------------------------------
>
>                 Key: OFBIZ-571
>                 URL: http://issues.apache.org/jira/browse/OFBIZ-571
>             Project: Apache OFBiz (The Open for Business Project)
>          Issue Type: Sub-task
>          Components: site
>            Reporter: Jacopo Cappellato
>         Assigned To: Jacques Le Roux
>         Attachments: AScreenCopy.PNG
>
>
> Move the various documentation pages and even the main Docs & Books page to the OFBTECH space on docs.ofbiz.org

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira