struts-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Christoph Nenning <Christoph.Nenn...@lex-com.net>
Subject Re: Struts2 documentation and Stack Overflow
Date Thu, 01 Sep 2016 06:45:51 GMT
> From: Doug Erickson <doug.erickson@part.net>
> To: Struts Users Mailing List <user@struts.apache.org>, 
> Date: 01.09.2016 02:04
> Subject: Re: Struts2 documentation and Stack Overflow
> 
> 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.
> 


Open Source lives from contributions. And documentation is a great area 
where community members can contribute ;)


Regards,
Christoph




> 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
> >

This Email was scanned by Sophos Anti Virus

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