struts-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ken McWilliams <ken.mcwilli...@gmail.com>
Subject Re: Documentation
Date Tue, 31 Jan 2017 17:29:00 GMT
Anything that makes document contribution easier is good!

A traditional wiki in my opinion would be most ideal. Just as it works for
Wikipedia (backed by mediawiki) you'll find that very few people will cause
an issue with documentation. It is also very beneficial if people can
create new pages/links too. All wikis have security to restrict certain
pages to certain users, so security bulletins etc. can be trusted. It is
really nice when you find a spelling error to just fix it then and there. A
wiki I like is Xwiki it's Java based and it happily cooperates with most
any DB. Both these wiki's are _very_ easy to set up. I think Xwiki uses
Struts... I think v2...It is a pretty nice and useful product (FLOSS).

A plausible option would be to create a wiki and export it's pages into the
main site. Not sure about that sort of flow but for the paranoid it would
allow an official checked version to exist, as well as a faster evolving
version. At the worst move the content with copy and paste.



On Tue, Jan 31, 2017 at 5:04 AM, Stefaan Dutry <stefaan.dutry@gmail.com>
wrote:

> Hello,
>
> I like the idea.
> I wouldn't mind helping with migrating the documentation.
>
> I would need at least 1 page as an example, and to know the exact
> location where you want the documentation to be placed.
>
> Regards,
>
> Stefaan Dutry
> (sdutry)
>
> Op 31 jan. 2017 10:45 a.m. schreef "Lukasz Lenart" <
> lukaszlenart@apache.org>:
> >
> > 2017-01-31 10:43 GMT+01:00 Christoph Nenning <
> Christoph.Nenning@lex-com.net>:
> > > Hi,
> > >
> > > sounds like a good idea!
> > >
> > > But also sounds like a lot of work. It will take probably plenty of
> time
> > > until it is finished. Every journey starts with a first step :)
> >
> > Not really a plenty of work as I want to just copy paste existing
> > Getting Started ;-) And then improved it over the time :)
> >
> >
> > Regards
> > --
> > Ɓukasz
> > + 48 606 323 122 http://www.lenart.org.pl/
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> > For additional commands, e-mail: dev-help@struts.apache.org
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
>


-- 
Sent from my C64 using a 300 baud modem

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