struts-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Doug Erickson <doug.erick...@part.net>
Subject Re: Struts2 documentation and Stack Overflow
Date Thu, 01 Sep 2016 00:04:21 GMT
Stack Overflow Documentation isn't meant to duplicate existing
documentation. It's intended to provide missing documentation and
compensate for poor documentation.

So, copying current documentation to SO is definitely not in line with
their goals.

It *could *be a place to create better documentation for Struts2, but I
don't think so. I think Documentation's focus on examples is wrong. As an
experienced Struts2 developer, when I need documentation, I want to look up
something specific in a reference guide. As a beginner, examples were more
helpful, but I would want to encounter them in a logical progression, not
the disorganized grab bag that Documentation uses.

If there's a commitment from Struts developers to improve documentation,
they should do it on the struts site. Documentation is a place for the
community to go to contribute their own documentation when maintainers fail
to do a good job.

On Wed, Aug 31, 2016 at 5:45 PM, Ken McWilliams <ken.mcwilliams@gmail.com>
wrote:

> StackOverflow is a pretty huge site and a lot of people seek out Struts2
> Q&A there, it would be nice if the Struts 2 documentation was available via
> the new StackOverflow documentation initiative.
>
> I was tempted to simply copy good chunks of the existing documentation,
> there is certainly room for improvement but starting from scratch is
> certainly a daunting effort.
>
> What is the view on copying data from struts.apache.org to SO? (I know
> there will be others from SO who follow this list and would probably do
> pretty reasonable and good things with a green light)
>
> Anyone can write a blurb, and it's looking a bit barren over there right
> now.
>
>
> --
> Sent from my C64 using a 300 baud modem
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message