[jira] [Commented] (OFBIZ-7499) Incorporate the readme for the Accounting component

["Taher Alkhateeb (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/OFBIZ-7499?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15443624#comment-15443624 ] 

Taher Alkhateeb commented on OFBIZ-7499:
----------------------------------------

This topic has been discussed recently in the ML, and some of the suggestions are to introduce a documentation framework like DocBook, dita, or asciibook for longer documentation and to restrain the README files to the minimum needed for people to get going.

Having a plethora of README files one in each component seems excessive to me and does not solve the problem of documentation (in fact it might make it worse) because now we need to decide what goes in the README and what goes in the other documentation solutions.

Again like discussed in other JIRAs I wish if you'd discuss your intentions in the ML before issuing JIRAs. Sometimes it makes sense to immediately create a JIRA when you discover a bug or fix something obvious. But when deciding on a policy like "Every component should have a README" then at a minimum I think it should be discussed in the mailing list to avoid over inflating the already over inflated JIRA issues.

> Incorporate the readme for the Accounting component
> ---------------------------------------------------
>
>                 Key: OFBIZ-7499
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-7499
>             Project: OFBiz
>          Issue Type: Sub-task
>          Components: accounting
>    Affects Versions: Trunk
>            Reporter: Pierre Smits
>            Assignee: Pierre Smits
>            Priority: Minor
>             Fix For: Upcoming Branch
>
>         Attachments: OFBIZ-7499-README.md.patch
>
>
> A readme should be the first starting point of each component for developers, and have references to the placeholder in the wiki, in jira and in svn/viewvc.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)