axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Afkham Azeez (JIRA)" <j...@apache.org>
Subject [jira] Updated: (AXIS2-3990) Produce Axis2 documentation in a form suitable for printing and offline reading
Date Thu, 06 Jan 2011 14:52:48 GMT

     [ https://issues.apache.org/jira/browse/AXIS2-3990?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Afkham Azeez updated AXIS2-3990:
--------------------------------

    Priority: Minor  (was: Major)
    Assignee: Dennis Sosnoski

> Produce Axis2 documentation in a form suitable for printing and offline reading
> -------------------------------------------------------------------------------
>
>                 Key: AXIS2-3990
>                 URL: https://issues.apache.org/jira/browse/AXIS2-3990
>             Project: Axis2
>          Issue Type: New Feature
>          Components: documentation
>    Affects Versions: 1.4.1
>            Reporter: David M. Karr
>            Assignee: Dennis Sosnoski
>            Priority: Minor
>
> I'm sure the people who work with Axis2 regularly, either as users or developers of the
framework, believe that the state of the project documentation is perfectly fine. What the
Wiki-style documentation lacks, however, is the ability to ingest the documentation in a printable
and readable form.
> The Wiki is perfectly fine as a reference, but it's not very useful for many people who
want something more. I'm sure the new Axis2 book will sell well, because it's probably the
only form of Axis2 documentation in that form that anyone can get a hold of.
> If you examine the model of the Spring and Hibernate projects, they produce a very readable
offline documentation set that someone can use to read about the details of the project in
a form that is convenient for them.
> I also believe that even if you agree with me, that the Axis2 project needs a good printable
(and up to date) documentation set, you would likely agree that this would take a lot of work
to produce.  I would also agree with that. It's a task that may never be completed. However,
as I didn't see an issue reported that addresses this question, I felt I should at least file
this, to get this on the record.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@axis.apache.org
For additional commands, e-mail: java-dev-help@axis.apache.org


Mime
View raw message