You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by Lukasz Lenart <lu...@apache.org> on 2013/11/05 08:34:45 UTC

Re: Re-organise docs

I'm wondering what is wrong with exposing only the latest Draft docs
and just forget about publishing docs on each release? Thus will
simplify keeping page update-2-date and reduce amount of time spend on
preparing new release.


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2013/10/30 Lukasz Lenart <lu...@apache.org>:
> There is one problem - to include docs in the assemblies they must be
> downloaded with wget (there is no support for SiteExporter in
> Jenkins).
> So, I must add a task which will export docs from Confluence and put
> them under /docs and then with wget they can be downloaded to Jenkins
> and assembled :\
>
> ech... bit messy solution, but I don't see other option.
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/9/10  <um...@gmail.com>:
>> +1 for that
>> It will reduce a lot of confusion
>> ------Original Message------
>> From: Lukasz Lenart
>> To: Struts Developers List
>> ReplyTo: Struts Developers List
>> Subject: Re-organise docs
>> Sent: Sep 10, 2013 12:18 PM
>>
>> Hi,
>>
>> I thought a bit about our docs - for each main branch we provide docs,
>> i.e. /release/2.3.x/, /release/2.2.x/ etc. We also expose draft docs
>> as /development/2.x - all thus leads to mess when we must update
>> something or so.
>>
>> So maybe just instead of many places with docs we should expose the
>> latest related to last release under path /docs and redirect to
>> Confluence in case of draft docs?
>>
>>
>> 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
>>
>>
>>
>> Sent from BlackBerry® on Airtel

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
I assume no objections and I can switch the branch.

2014-02-09 22:21 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
> Ok, done! All pages migrated, outdated removed, etc.
>
> http://people.apache.org/~lukaszlenart/
>
> To build site locally (install Jekyll first):
> - svn co http://svn.apache.org/repos/asf/struts/site/branches/jekyll-powered/
> struts-site
> - cd struts-site
> - jekyll serve
> - open http://localhost:4000/
>
> If no objections I'd like switch to Jekyll ASAP (I'm going to wait 72h
> to satisfy silent consensus)
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2014-02-09 9:49 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
>> First draft :-)
>>
>> http://people.apache.org/~lukaszlenart/
>>
>> Jekyll, jQuery 1.11.0, Bootstrap 3.1
>>
>>
>> Regards
>> --
>> Łukasz
>> + 48 606 323 122 http://www.lenart.org.pl/
>>
>> 2014-02-08 10:35 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
>>> Another thing - I have started site migration to Jekyll on dedicated branch
>>>
>>> http://svn.apache.org/repos/asf/struts/site/branches/jekyll-powered/
>>>
>>> 2014-01-22 11:35 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
>>>> I have started updating the site, right now moved the whole /dev to
>>>> Markdown and moved files to root folder. Please check if everything is
>>>> ok - WIP!
>>>>
>>>> http://struts.staging.apache.org/
>>>>
>>>> 2014/1/21 Lukasz Lenart <lu...@apache.org>:
>>>>> I don't see objections so I think we can start with that :-)
>>>>>
>>>>> 2014/1/9 Lukasz Lenart <lu...@apache.org>:
>>>>>> Infra doesn't have time to answer my questions [1] and it's a bit
>>>>>> annoying to wait with everything for them. So to not be dependent on
>>>>>> Infra I think we should move / create a user guide under website and
>>>>>> left Confluence / Wiki as a reference with more detailed informations.
>>>>>> Then the release process will only export the user guide which will be
>>>>>> included in packages.
>>>>>>
>>>>>> And to move things forward the best will be if we convert
>>>>>> https://cwiki.apache.org/confluence/display/WW/Getting+Started into
>>>>>> the user guide.
>>>>>>
>>>>>> [1] https://issues.apache.org/jira/browse/INFRA-6350
>>>>>>
>>>>>>
>>>>>> Regards
>>>>>> --
>>>>>> Łukasz
>>>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>
>>>>>> 2013/12/16 Paul Benedict <pb...@apache.org>:
>>>>>>> Years in the making. WOW! The Wiki documentation finally looks readable!
>>>>>>>
>>>>>>>
>>>>>>> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:
>>>>>>>
>>>>>>>> I have removed custom css, the space looks better now :-)
>>>>>>>>
>>>>>>>> https://cwiki.apache.org/confluence/display/WW/Home
>>>>>>>>
>>>>>>>>
>>>>>>>> Regards
>>>>>>>> --
>>>>>>>> Łukasz
>>>>>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>>>
>>>>>>>> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
>>>>>>>> > FYI
>>>>>>>> >
>>>>>>>> > Confluence was upgraded to version 5 and there are some problems with
>>>>>>>> > editing pages.
>>>>>>>> >
>>>>>>>> >
>>>>>>>> > Regards
>>>>>>>> > --
>>>>>>>> > Łukasz
>>>>>>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>>> >
>>>>>>>> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>>>>>>>> >> One more thing: everything editable will be moved to struts-site (i.e.
>>>>>>>> >> the new plugin.md) to don't mess with things generated by Maven
>>>>>>>> >>
>>>>>>>> >> So the project source code will contain only source code and JavaDocs,
>>>>>>>> >> the rest will be outside it.
>>>>>>>> >>
>>>>>>>> >>
>>>>>>>> >> Regards
>>>>>>>> >> --
>>>>>>>> >> Łukasz
>>>>>>>> >> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>>> >>
>>>>>>>> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
>>>>>>>> >>> Sounds good to me. The easier the better.
>>>>>>>> >>>
>>>>>>>> >>>
>>>>>>>> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
>>>>>>>> lukaszlenart@apache.org>wrote:
>>>>>>>> >>>
>>>>>>>> >>>> Still thinking how to organise everything, maybe instead common
>>>>>>>> >>>> /release/2.3.x and so on it'd be better to have something like that:
>>>>>>>> >>>>
>>>>>>>> >>>> /docs/latest -> latest development version
>>>>>>>> >>>> /docs/2.3.x
>>>>>>>> >>>> /docs/2.2.x
>>>>>>>> >>>> ...
>>>>>>>> >>>>
>>>>>>>> >>>> and
>>>>>>>> >>>>
>>>>>>>> >>>> /apidocs/latest -> the same as above
>>>>>>>> >>>> /apidocs/2.3.x
>>>>>>>> >>>> /apidocs/2.2.x
>>>>>>>> >>>> ...
>>>>>>>> >>>>
>>>>>>>> >>>> there be no more dedicated S2 subsite, everything will be put on the
>>>>>>>> >>>> top, also Maven reports will be thrown away.
>>>>>>>> >>>>
>>>>>>>> >>>>
>>>>>>>> >>>> Regards
>>>>>>>> >>>> --
>>>>>>>> >>>> Łukasz
>>>>>>>> >>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>>> >>>>
>>>>>>>> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>>>>>>> >>>> > Starting work on that - it must be resolved before next release
>>>>>>>> comes
>>>>>>>> >>>> out.
>>>>>>>> >>>> >
>>>>>>>> >>>> > My plan is to have two tasks:
>>>>>>>> >>>> > 1. it will export pages from Confluence and will put them under
>>>>>>>> /docs
>>>>>>>> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>>>>>>> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>>>>>>> >>>> >
>>>>>>>> >>>> > WDYT?
>>>>>>>> >>>> >
>>>>>>>> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>>>>>>> >>>> >
>>>>>>>> >>>> >
>>>>>>>> >>>> > Regards
>>>>>>>> >>>> > --
>>>>>>>> >>>> > Łukasz
>>>>>>>> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>>> >>>> >
>>>>>>>> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>>>>>>> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>>>>>>> >>>> >>> I usually find it a life-saver to see the docs of previous
>>>>>>>> versions.
>>>>>>>> >>>> Not
>>>>>>>> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>>>>>>> >>>> features
>>>>>>>> >>>> >>> to what was before. I think we definitely need to keep the docs
>>>>>>>> of the
>>>>>>>> >>>> >>> previously published versions around.
>>>>>>>> >>>> >>
>>>>>>>> >>>> >> But you meant to have the Draft docs and the latest released
>>>>>>>> version?
>>>>>>>> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>>>>>>> >>>> >>
>>>>>>>> >>>> >>> If you don't want to do that, then I think the latest docs need to
>>>>>>>> >>>> contain
>>>>>>>> >>>> >>> some sort of history on feature changes/upgrades.
>>>>>>>> >>>> >>
>>>>>>>> >>>> >> Hm... I think it's easier to keep few versions ;-)
>>>>>>>> >>>> >>
>>>>>>>> >>>> >>
>>>>>>>> >>>> >> 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
>>>>>>>> >>>>
>>>>>>>> >>>>
>>>>>>>> >>>
>>>>>>>> >>>
>>>>>>>> >>> --
>>>>>>>> >>> Cheers,
>>>>>>>> >>> Paul
>>>>>>>>
>>>>>>>> ---------------------------------------------------------------------
>>>>>>>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>>>>>>>> For additional commands, e-mail: dev-help@struts.apache.org
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> --
>>>>>>> Cheers,
>>>>>>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
Ok, done! All pages migrated, outdated removed, etc.

http://people.apache.org/~lukaszlenart/

To build site locally (install Jekyll first):
- svn co http://svn.apache.org/repos/asf/struts/site/branches/jekyll-powered/
struts-site
- cd struts-site
- jekyll serve
- open http://localhost:4000/

If no objections I'd like switch to Jekyll ASAP (I'm going to wait 72h
to satisfy silent consensus)


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2014-02-09 9:49 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
> First draft :-)
>
> http://people.apache.org/~lukaszlenart/
>
> Jekyll, jQuery 1.11.0, Bootstrap 3.1
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2014-02-08 10:35 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
>> Another thing - I have started site migration to Jekyll on dedicated branch
>>
>> http://svn.apache.org/repos/asf/struts/site/branches/jekyll-powered/
>>
>> 2014-01-22 11:35 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
>>> I have started updating the site, right now moved the whole /dev to
>>> Markdown and moved files to root folder. Please check if everything is
>>> ok - WIP!
>>>
>>> http://struts.staging.apache.org/
>>>
>>> 2014/1/21 Lukasz Lenart <lu...@apache.org>:
>>>> I don't see objections so I think we can start with that :-)
>>>>
>>>> 2014/1/9 Lukasz Lenart <lu...@apache.org>:
>>>>> Infra doesn't have time to answer my questions [1] and it's a bit
>>>>> annoying to wait with everything for them. So to not be dependent on
>>>>> Infra I think we should move / create a user guide under website and
>>>>> left Confluence / Wiki as a reference with more detailed informations.
>>>>> Then the release process will only export the user guide which will be
>>>>> included in packages.
>>>>>
>>>>> And to move things forward the best will be if we convert
>>>>> https://cwiki.apache.org/confluence/display/WW/Getting+Started into
>>>>> the user guide.
>>>>>
>>>>> [1] https://issues.apache.org/jira/browse/INFRA-6350
>>>>>
>>>>>
>>>>> Regards
>>>>> --
>>>>> Łukasz
>>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>
>>>>> 2013/12/16 Paul Benedict <pb...@apache.org>:
>>>>>> Years in the making. WOW! The Wiki documentation finally looks readable!
>>>>>>
>>>>>>
>>>>>> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:
>>>>>>
>>>>>>> I have removed custom css, the space looks better now :-)
>>>>>>>
>>>>>>> https://cwiki.apache.org/confluence/display/WW/Home
>>>>>>>
>>>>>>>
>>>>>>> Regards
>>>>>>> --
>>>>>>> Łukasz
>>>>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>>
>>>>>>> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
>>>>>>> > FYI
>>>>>>> >
>>>>>>> > Confluence was upgraded to version 5 and there are some problems with
>>>>>>> > editing pages.
>>>>>>> >
>>>>>>> >
>>>>>>> > Regards
>>>>>>> > --
>>>>>>> > Łukasz
>>>>>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>> >
>>>>>>> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>>>>>>> >> One more thing: everything editable will be moved to struts-site (i.e.
>>>>>>> >> the new plugin.md) to don't mess with things generated by Maven
>>>>>>> >>
>>>>>>> >> So the project source code will contain only source code and JavaDocs,
>>>>>>> >> the rest will be outside it.
>>>>>>> >>
>>>>>>> >>
>>>>>>> >> Regards
>>>>>>> >> --
>>>>>>> >> Łukasz
>>>>>>> >> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>> >>
>>>>>>> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
>>>>>>> >>> Sounds good to me. The easier the better.
>>>>>>> >>>
>>>>>>> >>>
>>>>>>> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
>>>>>>> lukaszlenart@apache.org>wrote:
>>>>>>> >>>
>>>>>>> >>>> Still thinking how to organise everything, maybe instead common
>>>>>>> >>>> /release/2.3.x and so on it'd be better to have something like that:
>>>>>>> >>>>
>>>>>>> >>>> /docs/latest -> latest development version
>>>>>>> >>>> /docs/2.3.x
>>>>>>> >>>> /docs/2.2.x
>>>>>>> >>>> ...
>>>>>>> >>>>
>>>>>>> >>>> and
>>>>>>> >>>>
>>>>>>> >>>> /apidocs/latest -> the same as above
>>>>>>> >>>> /apidocs/2.3.x
>>>>>>> >>>> /apidocs/2.2.x
>>>>>>> >>>> ...
>>>>>>> >>>>
>>>>>>> >>>> there be no more dedicated S2 subsite, everything will be put on the
>>>>>>> >>>> top, also Maven reports will be thrown away.
>>>>>>> >>>>
>>>>>>> >>>>
>>>>>>> >>>> Regards
>>>>>>> >>>> --
>>>>>>> >>>> Łukasz
>>>>>>> >>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>> >>>>
>>>>>>> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>>>>>> >>>> > Starting work on that - it must be resolved before next release
>>>>>>> comes
>>>>>>> >>>> out.
>>>>>>> >>>> >
>>>>>>> >>>> > My plan is to have two tasks:
>>>>>>> >>>> > 1. it will export pages from Confluence and will put them under
>>>>>>> /docs
>>>>>>> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>>>>>> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>>>>>> >>>> >
>>>>>>> >>>> > WDYT?
>>>>>>> >>>> >
>>>>>>> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>>>>>> >>>> >
>>>>>>> >>>> >
>>>>>>> >>>> > Regards
>>>>>>> >>>> > --
>>>>>>> >>>> > Łukasz
>>>>>>> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>> >>>> >
>>>>>>> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>>>>>> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>>>>>> >>>> >>> I usually find it a life-saver to see the docs of previous
>>>>>>> versions.
>>>>>>> >>>> Not
>>>>>>> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>>>>>> >>>> features
>>>>>>> >>>> >>> to what was before. I think we definitely need to keep the docs
>>>>>>> of the
>>>>>>> >>>> >>> previously published versions around.
>>>>>>> >>>> >>
>>>>>>> >>>> >> But you meant to have the Draft docs and the latest released
>>>>>>> version?
>>>>>>> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>>>>>> >>>> >>
>>>>>>> >>>> >>> If you don't want to do that, then I think the latest docs need to
>>>>>>> >>>> contain
>>>>>>> >>>> >>> some sort of history on feature changes/upgrades.
>>>>>>> >>>> >>
>>>>>>> >>>> >> Hm... I think it's easier to keep few versions ;-)
>>>>>>> >>>> >>
>>>>>>> >>>> >>
>>>>>>> >>>> >> 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
>>>>>>> >>>>
>>>>>>> >>>>
>>>>>>> >>>
>>>>>>> >>>
>>>>>>> >>> --
>>>>>>> >>> Cheers,
>>>>>>> >>> Paul
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>>>>>>> For additional commands, e-mail: dev-help@struts.apache.org
>>>>>>>
>>>>>>>
>>>>>>
>>>>>>
>>>>>> --
>>>>>> Cheers,
>>>>>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
First draft :-)

http://people.apache.org/~lukaszlenart/

Jekyll, jQuery 1.11.0, Bootstrap 3.1


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2014-02-08 10:35 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
> Another thing - I have started site migration to Jekyll on dedicated branch
>
> http://svn.apache.org/repos/asf/struts/site/branches/jekyll-powered/
>
> 2014-01-22 11:35 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
>> I have started updating the site, right now moved the whole /dev to
>> Markdown and moved files to root folder. Please check if everything is
>> ok - WIP!
>>
>> http://struts.staging.apache.org/
>>
>> 2014/1/21 Lukasz Lenart <lu...@apache.org>:
>>> I don't see objections so I think we can start with that :-)
>>>
>>> 2014/1/9 Lukasz Lenart <lu...@apache.org>:
>>>> Infra doesn't have time to answer my questions [1] and it's a bit
>>>> annoying to wait with everything for them. So to not be dependent on
>>>> Infra I think we should move / create a user guide under website and
>>>> left Confluence / Wiki as a reference with more detailed informations.
>>>> Then the release process will only export the user guide which will be
>>>> included in packages.
>>>>
>>>> And to move things forward the best will be if we convert
>>>> https://cwiki.apache.org/confluence/display/WW/Getting+Started into
>>>> the user guide.
>>>>
>>>> [1] https://issues.apache.org/jira/browse/INFRA-6350
>>>>
>>>>
>>>> Regards
>>>> --
>>>> Łukasz
>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>
>>>> 2013/12/16 Paul Benedict <pb...@apache.org>:
>>>>> Years in the making. WOW! The Wiki documentation finally looks readable!
>>>>>
>>>>>
>>>>> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:
>>>>>
>>>>>> I have removed custom css, the space looks better now :-)
>>>>>>
>>>>>> https://cwiki.apache.org/confluence/display/WW/Home
>>>>>>
>>>>>>
>>>>>> Regards
>>>>>> --
>>>>>> Łukasz
>>>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>>
>>>>>> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
>>>>>> > FYI
>>>>>> >
>>>>>> > Confluence was upgraded to version 5 and there are some problems with
>>>>>> > editing pages.
>>>>>> >
>>>>>> >
>>>>>> > Regards
>>>>>> > --
>>>>>> > Łukasz
>>>>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>>> >
>>>>>> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>>>>>> >> One more thing: everything editable will be moved to struts-site (i.e.
>>>>>> >> the new plugin.md) to don't mess with things generated by Maven
>>>>>> >>
>>>>>> >> So the project source code will contain only source code and JavaDocs,
>>>>>> >> the rest will be outside it.
>>>>>> >>
>>>>>> >>
>>>>>> >> Regards
>>>>>> >> --
>>>>>> >> Łukasz
>>>>>> >> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>> >>
>>>>>> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
>>>>>> >>> Sounds good to me. The easier the better.
>>>>>> >>>
>>>>>> >>>
>>>>>> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
>>>>>> lukaszlenart@apache.org>wrote:
>>>>>> >>>
>>>>>> >>>> Still thinking how to organise everything, maybe instead common
>>>>>> >>>> /release/2.3.x and so on it'd be better to have something like that:
>>>>>> >>>>
>>>>>> >>>> /docs/latest -> latest development version
>>>>>> >>>> /docs/2.3.x
>>>>>> >>>> /docs/2.2.x
>>>>>> >>>> ...
>>>>>> >>>>
>>>>>> >>>> and
>>>>>> >>>>
>>>>>> >>>> /apidocs/latest -> the same as above
>>>>>> >>>> /apidocs/2.3.x
>>>>>> >>>> /apidocs/2.2.x
>>>>>> >>>> ...
>>>>>> >>>>
>>>>>> >>>> there be no more dedicated S2 subsite, everything will be put on the
>>>>>> >>>> top, also Maven reports will be thrown away.
>>>>>> >>>>
>>>>>> >>>>
>>>>>> >>>> Regards
>>>>>> >>>> --
>>>>>> >>>> Łukasz
>>>>>> >>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>> >>>>
>>>>>> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>>>>> >>>> > Starting work on that - it must be resolved before next release
>>>>>> comes
>>>>>> >>>> out.
>>>>>> >>>> >
>>>>>> >>>> > My plan is to have two tasks:
>>>>>> >>>> > 1. it will export pages from Confluence and will put them under
>>>>>> /docs
>>>>>> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>>>>> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>>>>> >>>> >
>>>>>> >>>> > WDYT?
>>>>>> >>>> >
>>>>>> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>>>>> >>>> >
>>>>>> >>>> >
>>>>>> >>>> > Regards
>>>>>> >>>> > --
>>>>>> >>>> > Łukasz
>>>>>> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>>> >>>> >
>>>>>> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>>>>> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>>>>> >>>> >>> I usually find it a life-saver to see the docs of previous
>>>>>> versions.
>>>>>> >>>> Not
>>>>>> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>>>>> >>>> features
>>>>>> >>>> >>> to what was before. I think we definitely need to keep the docs
>>>>>> of the
>>>>>> >>>> >>> previously published versions around.
>>>>>> >>>> >>
>>>>>> >>>> >> But you meant to have the Draft docs and the latest released
>>>>>> version?
>>>>>> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>>>>> >>>> >>
>>>>>> >>>> >>> If you don't want to do that, then I think the latest docs need to
>>>>>> >>>> contain
>>>>>> >>>> >>> some sort of history on feature changes/upgrades.
>>>>>> >>>> >>
>>>>>> >>>> >> Hm... I think it's easier to keep few versions ;-)
>>>>>> >>>> >>
>>>>>> >>>> >>
>>>>>> >>>> >> 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
>>>>>> >>>>
>>>>>> >>>>
>>>>>> >>>
>>>>>> >>>
>>>>>> >>> --
>>>>>> >>> Cheers,
>>>>>> >>> Paul
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>>>>>> For additional commands, e-mail: dev-help@struts.apache.org
>>>>>>
>>>>>>
>>>>>
>>>>>
>>>>> --
>>>>> Cheers,
>>>>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
Another thing - I have started site migration to Jekyll on dedicated branch

http://svn.apache.org/repos/asf/struts/site/branches/jekyll-powered/

2014-01-22 11:35 GMT+01:00 Lukasz Lenart <lu...@apache.org>:
> I have started updating the site, right now moved the whole /dev to
> Markdown and moved files to root folder. Please check if everything is
> ok - WIP!
>
> http://struts.staging.apache.org/
>
> 2014/1/21 Lukasz Lenart <lu...@apache.org>:
>> I don't see objections so I think we can start with that :-)
>>
>> 2014/1/9 Lukasz Lenart <lu...@apache.org>:
>>> Infra doesn't have time to answer my questions [1] and it's a bit
>>> annoying to wait with everything for them. So to not be dependent on
>>> Infra I think we should move / create a user guide under website and
>>> left Confluence / Wiki as a reference with more detailed informations.
>>> Then the release process will only export the user guide which will be
>>> included in packages.
>>>
>>> And to move things forward the best will be if we convert
>>> https://cwiki.apache.org/confluence/display/WW/Getting+Started into
>>> the user guide.
>>>
>>> [1] https://issues.apache.org/jira/browse/INFRA-6350
>>>
>>>
>>> Regards
>>> --
>>> Łukasz
>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>
>>> 2013/12/16 Paul Benedict <pb...@apache.org>:
>>>> Years in the making. WOW! The Wiki documentation finally looks readable!
>>>>
>>>>
>>>> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:
>>>>
>>>>> I have removed custom css, the space looks better now :-)
>>>>>
>>>>> https://cwiki.apache.org/confluence/display/WW/Home
>>>>>
>>>>>
>>>>> Regards
>>>>> --
>>>>> Łukasz
>>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>>
>>>>> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
>>>>> > FYI
>>>>> >
>>>>> > Confluence was upgraded to version 5 and there are some problems with
>>>>> > editing pages.
>>>>> >
>>>>> >
>>>>> > Regards
>>>>> > --
>>>>> > Łukasz
>>>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>> >
>>>>> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>>>>> >> One more thing: everything editable will be moved to struts-site (i.e.
>>>>> >> the new plugin.md) to don't mess with things generated by Maven
>>>>> >>
>>>>> >> So the project source code will contain only source code and JavaDocs,
>>>>> >> the rest will be outside it.
>>>>> >>
>>>>> >>
>>>>> >> Regards
>>>>> >> --
>>>>> >> Łukasz
>>>>> >> + 48 606 323 122 http://www.lenart.org.pl/
>>>>> >>
>>>>> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
>>>>> >>> Sounds good to me. The easier the better.
>>>>> >>>
>>>>> >>>
>>>>> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
>>>>> lukaszlenart@apache.org>wrote:
>>>>> >>>
>>>>> >>>> Still thinking how to organise everything, maybe instead common
>>>>> >>>> /release/2.3.x and so on it'd be better to have something like that:
>>>>> >>>>
>>>>> >>>> /docs/latest -> latest development version
>>>>> >>>> /docs/2.3.x
>>>>> >>>> /docs/2.2.x
>>>>> >>>> ...
>>>>> >>>>
>>>>> >>>> and
>>>>> >>>>
>>>>> >>>> /apidocs/latest -> the same as above
>>>>> >>>> /apidocs/2.3.x
>>>>> >>>> /apidocs/2.2.x
>>>>> >>>> ...
>>>>> >>>>
>>>>> >>>> there be no more dedicated S2 subsite, everything will be put on the
>>>>> >>>> top, also Maven reports will be thrown away.
>>>>> >>>>
>>>>> >>>>
>>>>> >>>> Regards
>>>>> >>>> --
>>>>> >>>> Łukasz
>>>>> >>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>> >>>>
>>>>> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>>>> >>>> > Starting work on that - it must be resolved before next release
>>>>> comes
>>>>> >>>> out.
>>>>> >>>> >
>>>>> >>>> > My plan is to have two tasks:
>>>>> >>>> > 1. it will export pages from Confluence and will put them under
>>>>> /docs
>>>>> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>>>> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>>>> >>>> >
>>>>> >>>> > WDYT?
>>>>> >>>> >
>>>>> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>>>> >>>> >
>>>>> >>>> >
>>>>> >>>> > Regards
>>>>> >>>> > --
>>>>> >>>> > Łukasz
>>>>> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>>> >>>> >
>>>>> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>>>> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>>>> >>>> >>> I usually find it a life-saver to see the docs of previous
>>>>> versions.
>>>>> >>>> Not
>>>>> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>>>> >>>> features
>>>>> >>>> >>> to what was before. I think we definitely need to keep the docs
>>>>> of the
>>>>> >>>> >>> previously published versions around.
>>>>> >>>> >>
>>>>> >>>> >> But you meant to have the Draft docs and the latest released
>>>>> version?
>>>>> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>>>> >>>> >>
>>>>> >>>> >>> If you don't want to do that, then I think the latest docs need to
>>>>> >>>> contain
>>>>> >>>> >>> some sort of history on feature changes/upgrades.
>>>>> >>>> >>
>>>>> >>>> >> Hm... I think it's easier to keep few versions ;-)
>>>>> >>>> >>
>>>>> >>>> >>
>>>>> >>>> >> 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
>>>>> >>>>
>>>>> >>>>
>>>>> >>>
>>>>> >>>
>>>>> >>> --
>>>>> >>> Cheers,
>>>>> >>> Paul
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>>>>> For additional commands, e-mail: dev-help@struts.apache.org
>>>>>
>>>>>
>>>>
>>>>
>>>> --
>>>> Cheers,
>>>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
I have started updating the site, right now moved the whole /dev to
Markdown and moved files to root folder. Please check if everything is
ok - WIP!

http://struts.staging.apache.org/

2014/1/21 Lukasz Lenart <lu...@apache.org>:
> I don't see objections so I think we can start with that :-)
>
> 2014/1/9 Lukasz Lenart <lu...@apache.org>:
>> Infra doesn't have time to answer my questions [1] and it's a bit
>> annoying to wait with everything for them. So to not be dependent on
>> Infra I think we should move / create a user guide under website and
>> left Confluence / Wiki as a reference with more detailed informations.
>> Then the release process will only export the user guide which will be
>> included in packages.
>>
>> And to move things forward the best will be if we convert
>> https://cwiki.apache.org/confluence/display/WW/Getting+Started into
>> the user guide.
>>
>> [1] https://issues.apache.org/jira/browse/INFRA-6350
>>
>>
>> Regards
>> --
>> Łukasz
>> + 48 606 323 122 http://www.lenart.org.pl/
>>
>> 2013/12/16 Paul Benedict <pb...@apache.org>:
>>> Years in the making. WOW! The Wiki documentation finally looks readable!
>>>
>>>
>>> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:
>>>
>>>> I have removed custom css, the space looks better now :-)
>>>>
>>>> https://cwiki.apache.org/confluence/display/WW/Home
>>>>
>>>>
>>>> Regards
>>>> --
>>>> Łukasz
>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>
>>>> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
>>>> > FYI
>>>> >
>>>> > Confluence was upgraded to version 5 and there are some problems with
>>>> > editing pages.
>>>> >
>>>> >
>>>> > Regards
>>>> > --
>>>> > Łukasz
>>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>> >
>>>> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>>>> >> One more thing: everything editable will be moved to struts-site (i.e.
>>>> >> the new plugin.md) to don't mess with things generated by Maven
>>>> >>
>>>> >> So the project source code will contain only source code and JavaDocs,
>>>> >> the rest will be outside it.
>>>> >>
>>>> >>
>>>> >> Regards
>>>> >> --
>>>> >> Łukasz
>>>> >> + 48 606 323 122 http://www.lenart.org.pl/
>>>> >>
>>>> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
>>>> >>> Sounds good to me. The easier the better.
>>>> >>>
>>>> >>>
>>>> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
>>>> lukaszlenart@apache.org>wrote:
>>>> >>>
>>>> >>>> Still thinking how to organise everything, maybe instead common
>>>> >>>> /release/2.3.x and so on it'd be better to have something like that:
>>>> >>>>
>>>> >>>> /docs/latest -> latest development version
>>>> >>>> /docs/2.3.x
>>>> >>>> /docs/2.2.x
>>>> >>>> ...
>>>> >>>>
>>>> >>>> and
>>>> >>>>
>>>> >>>> /apidocs/latest -> the same as above
>>>> >>>> /apidocs/2.3.x
>>>> >>>> /apidocs/2.2.x
>>>> >>>> ...
>>>> >>>>
>>>> >>>> there be no more dedicated S2 subsite, everything will be put on the
>>>> >>>> top, also Maven reports will be thrown away.
>>>> >>>>
>>>> >>>>
>>>> >>>> Regards
>>>> >>>> --
>>>> >>>> Łukasz
>>>> >>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>> >>>>
>>>> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>>> >>>> > Starting work on that - it must be resolved before next release
>>>> comes
>>>> >>>> out.
>>>> >>>> >
>>>> >>>> > My plan is to have two tasks:
>>>> >>>> > 1. it will export pages from Confluence and will put them under
>>>> /docs
>>>> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>>> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>>> >>>> >
>>>> >>>> > WDYT?
>>>> >>>> >
>>>> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>>> >>>> >
>>>> >>>> >
>>>> >>>> > Regards
>>>> >>>> > --
>>>> >>>> > Łukasz
>>>> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>> >>>> >
>>>> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>>> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>>> >>>> >>> I usually find it a life-saver to see the docs of previous
>>>> versions.
>>>> >>>> Not
>>>> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>>> >>>> features
>>>> >>>> >>> to what was before. I think we definitely need to keep the docs
>>>> of the
>>>> >>>> >>> previously published versions around.
>>>> >>>> >>
>>>> >>>> >> But you meant to have the Draft docs and the latest released
>>>> version?
>>>> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>>> >>>> >>
>>>> >>>> >>> If you don't want to do that, then I think the latest docs need to
>>>> >>>> contain
>>>> >>>> >>> some sort of history on feature changes/upgrades.
>>>> >>>> >>
>>>> >>>> >> Hm... I think it's easier to keep few versions ;-)
>>>> >>>> >>
>>>> >>>> >>
>>>> >>>> >> 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
>>>> >>>>
>>>> >>>>
>>>> >>>
>>>> >>>
>>>> >>> --
>>>> >>> Cheers,
>>>> >>> Paul
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>>>> For additional commands, e-mail: dev-help@struts.apache.org
>>>>
>>>>
>>>
>>>
>>> --
>>> Cheers,
>>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
I don't see objections so I think we can start with that :-)

2014/1/9 Lukasz Lenart <lu...@apache.org>:
> Infra doesn't have time to answer my questions [1] and it's a bit
> annoying to wait with everything for them. So to not be dependent on
> Infra I think we should move / create a user guide under website and
> left Confluence / Wiki as a reference with more detailed informations.
> Then the release process will only export the user guide which will be
> included in packages.
>
> And to move things forward the best will be if we convert
> https://cwiki.apache.org/confluence/display/WW/Getting+Started into
> the user guide.
>
> [1] https://issues.apache.org/jira/browse/INFRA-6350
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/12/16 Paul Benedict <pb...@apache.org>:
>> Years in the making. WOW! The Wiki documentation finally looks readable!
>>
>>
>> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:
>>
>>> I have removed custom css, the space looks better now :-)
>>>
>>> https://cwiki.apache.org/confluence/display/WW/Home
>>>
>>>
>>> Regards
>>> --
>>> Łukasz
>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>
>>> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
>>> > FYI
>>> >
>>> > Confluence was upgraded to version 5 and there are some problems with
>>> > editing pages.
>>> >
>>> >
>>> > Regards
>>> > --
>>> > Łukasz
>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>> >
>>> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>>> >> One more thing: everything editable will be moved to struts-site (i.e.
>>> >> the new plugin.md) to don't mess with things generated by Maven
>>> >>
>>> >> So the project source code will contain only source code and JavaDocs,
>>> >> the rest will be outside it.
>>> >>
>>> >>
>>> >> Regards
>>> >> --
>>> >> Łukasz
>>> >> + 48 606 323 122 http://www.lenart.org.pl/
>>> >>
>>> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
>>> >>> Sounds good to me. The easier the better.
>>> >>>
>>> >>>
>>> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
>>> lukaszlenart@apache.org>wrote:
>>> >>>
>>> >>>> Still thinking how to organise everything, maybe instead common
>>> >>>> /release/2.3.x and so on it'd be better to have something like that:
>>> >>>>
>>> >>>> /docs/latest -> latest development version
>>> >>>> /docs/2.3.x
>>> >>>> /docs/2.2.x
>>> >>>> ...
>>> >>>>
>>> >>>> and
>>> >>>>
>>> >>>> /apidocs/latest -> the same as above
>>> >>>> /apidocs/2.3.x
>>> >>>> /apidocs/2.2.x
>>> >>>> ...
>>> >>>>
>>> >>>> there be no more dedicated S2 subsite, everything will be put on the
>>> >>>> top, also Maven reports will be thrown away.
>>> >>>>
>>> >>>>
>>> >>>> Regards
>>> >>>> --
>>> >>>> Łukasz
>>> >>>> + 48 606 323 122 http://www.lenart.org.pl/
>>> >>>>
>>> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>> >>>> > Starting work on that - it must be resolved before next release
>>> comes
>>> >>>> out.
>>> >>>> >
>>> >>>> > My plan is to have two tasks:
>>> >>>> > 1. it will export pages from Confluence and will put them under
>>> /docs
>>> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>> >>>> >
>>> >>>> > WDYT?
>>> >>>> >
>>> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>> >>>> >
>>> >>>> >
>>> >>>> > Regards
>>> >>>> > --
>>> >>>> > Łukasz
>>> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>> >>>> >
>>> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>> >>>> >>> I usually find it a life-saver to see the docs of previous
>>> versions.
>>> >>>> Not
>>> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>> >>>> features
>>> >>>> >>> to what was before. I think we definitely need to keep the docs
>>> of the
>>> >>>> >>> previously published versions around.
>>> >>>> >>
>>> >>>> >> But you meant to have the Draft docs and the latest released
>>> version?
>>> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>> >>>> >>
>>> >>>> >>> If you don't want to do that, then I think the latest docs need to
>>> >>>> contain
>>> >>>> >>> some sort of history on feature changes/upgrades.
>>> >>>> >>
>>> >>>> >> Hm... I think it's easier to keep few versions ;-)
>>> >>>> >>
>>> >>>> >>
>>> >>>> >> 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
>>> >>>>
>>> >>>>
>>> >>>
>>> >>>
>>> >>> --
>>> >>> Cheers,
>>> >>> Paul
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>>> For additional commands, e-mail: dev-help@struts.apache.org
>>>
>>>
>>
>>
>> --
>> Cheers,
>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
Infra doesn't have time to answer my questions [1] and it's a bit
annoying to wait with everything for them. So to not be dependent on
Infra I think we should move / create a user guide under website and
left Confluence / Wiki as a reference with more detailed informations.
Then the release process will only export the user guide which will be
included in packages.

And to move things forward the best will be if we convert
https://cwiki.apache.org/confluence/display/WW/Getting+Started into
the user guide.

[1] https://issues.apache.org/jira/browse/INFRA-6350


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2013/12/16 Paul Benedict <pb...@apache.org>:
> Years in the making. WOW! The Wiki documentation finally looks readable!
>
>
> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:
>
>> I have removed custom css, the space looks better now :-)
>>
>> https://cwiki.apache.org/confluence/display/WW/Home
>>
>>
>> Regards
>> --
>> Łukasz
>> + 48 606 323 122 http://www.lenart.org.pl/
>>
>> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
>> > FYI
>> >
>> > Confluence was upgraded to version 5 and there are some problems with
>> > editing pages.
>> >
>> >
>> > Regards
>> > --
>> > Łukasz
>> > + 48 606 323 122 http://www.lenart.org.pl/
>> >
>> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>> >> One more thing: everything editable will be moved to struts-site (i.e.
>> >> the new plugin.md) to don't mess with things generated by Maven
>> >>
>> >> So the project source code will contain only source code and JavaDocs,
>> >> the rest will be outside it.
>> >>
>> >>
>> >> Regards
>> >> --
>> >> Łukasz
>> >> + 48 606 323 122 http://www.lenart.org.pl/
>> >>
>> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
>> >>> Sounds good to me. The easier the better.
>> >>>
>> >>>
>> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
>> lukaszlenart@apache.org>wrote:
>> >>>
>> >>>> Still thinking how to organise everything, maybe instead common
>> >>>> /release/2.3.x and so on it'd be better to have something like that:
>> >>>>
>> >>>> /docs/latest -> latest development version
>> >>>> /docs/2.3.x
>> >>>> /docs/2.2.x
>> >>>> ...
>> >>>>
>> >>>> and
>> >>>>
>> >>>> /apidocs/latest -> the same as above
>> >>>> /apidocs/2.3.x
>> >>>> /apidocs/2.2.x
>> >>>> ...
>> >>>>
>> >>>> there be no more dedicated S2 subsite, everything will be put on the
>> >>>> top, also Maven reports will be thrown away.
>> >>>>
>> >>>>
>> >>>> Regards
>> >>>> --
>> >>>> Łukasz
>> >>>> + 48 606 323 122 http://www.lenart.org.pl/
>> >>>>
>> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>> >>>> > Starting work on that - it must be resolved before next release
>> comes
>> >>>> out.
>> >>>> >
>> >>>> > My plan is to have two tasks:
>> >>>> > 1. it will export pages from Confluence and will put them under
>> /docs
>> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
>> >>>> >
>> >>>> > WDYT?
>> >>>> >
>> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
>> >>>> >
>> >>>> >
>> >>>> > Regards
>> >>>> > --
>> >>>> > Łukasz
>> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
>> >>>> >
>> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>> >>>> >>> I usually find it a life-saver to see the docs of previous
>> versions.
>> >>>> Not
>> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>> >>>> features
>> >>>> >>> to what was before. I think we definitely need to keep the docs
>> of the
>> >>>> >>> previously published versions around.
>> >>>> >>
>> >>>> >> But you meant to have the Draft docs and the latest released
>> version?
>> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>> >>>> >>
>> >>>> >>> If you don't want to do that, then I think the latest docs need to
>> >>>> contain
>> >>>> >>> some sort of history on feature changes/upgrades.
>> >>>> >>
>> >>>> >> Hm... I think it's easier to keep few versions ;-)
>> >>>> >>
>> >>>> >>
>> >>>> >> 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
>> >>>>
>> >>>>
>> >>>
>> >>>
>> >>> --
>> >>> Cheers,
>> >>> Paul
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>> For additional commands, e-mail: dev-help@struts.apache.org
>>
>>
>
>
> --
> Cheers,
> Paul

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

Re: Re-organise docs

Posted by Paul Benedict <pb...@apache.org>.
Years in the making. WOW! The Wiki documentation finally looks readable!


On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lu...@apache.org>wrote:

> I have removed custom css, the space looks better now :-)
>
> https://cwiki.apache.org/confluence/display/WW/Home
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/12/16 Lukasz Lenart <lu...@apache.org>:
> > FYI
> >
> > Confluence was upgraded to version 5 and there are some problems with
> > editing pages.
> >
> >
> > Regards
> > --
> > Łukasz
> > + 48 606 323 122 http://www.lenart.org.pl/
> >
> > 2013/12/11 Lukasz Lenart <lu...@apache.org>:
> >> One more thing: everything editable will be moved to struts-site (i.e.
> >> the new plugin.md) to don't mess with things generated by Maven
> >>
> >> So the project source code will contain only source code and JavaDocs,
> >> the rest will be outside it.
> >>
> >>
> >> Regards
> >> --
> >> Łukasz
> >> + 48 606 323 122 http://www.lenart.org.pl/
> >>
> >> 2013/12/11 Paul Benedict <pb...@apache.org>:
> >>> Sounds good to me. The easier the better.
> >>>
> >>>
> >>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <
> lukaszlenart@apache.org>wrote:
> >>>
> >>>> Still thinking how to organise everything, maybe instead common
> >>>> /release/2.3.x and so on it'd be better to have something like that:
> >>>>
> >>>> /docs/latest -> latest development version
> >>>> /docs/2.3.x
> >>>> /docs/2.2.x
> >>>> ...
> >>>>
> >>>> and
> >>>>
> >>>> /apidocs/latest -> the same as above
> >>>> /apidocs/2.3.x
> >>>> /apidocs/2.2.x
> >>>> ...
> >>>>
> >>>> there be no more dedicated S2 subsite, everything will be put on the
> >>>> top, also Maven reports will be thrown away.
> >>>>
> >>>>
> >>>> Regards
> >>>> --
> >>>> Łukasz
> >>>> + 48 606 323 122 http://www.lenart.org.pl/
> >>>>
> >>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
> >>>> > Starting work on that - it must be resolved before next release
> comes
> >>>> out.
> >>>> >
> >>>> > My plan is to have two tasks:
> >>>> > 1. it will export pages from Confluence and will put them under
> /docs
> >>>> > 2. used after release to update JavaDocs (regenerate from tag) and
> >>>> > Docs (copy from /docs to /release/2.3.x/docs)
> >>>> >
> >>>> > WDYT?
> >>>> >
> >>>> > https://issues.apache.org/jira/browse/INFRA-6350
> >>>> >
> >>>> >
> >>>> > Regards
> >>>> > --
> >>>> > Łukasz
> >>>> > + 48 606 323 122 http://www.lenart.org.pl/
> >>>> >
> >>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
> >>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
> >>>> >>> I usually find it a life-saver to see the docs of previous
> versions.
> >>>> Not
> >>>> >>> everyone upgrades and it's impossible to compare latest syntax and
> >>>> features
> >>>> >>> to what was before. I think we definitely need to keep the docs
> of the
> >>>> >>> previously published versions around.
> >>>> >>
> >>>> >> But you meant to have the Draft docs and the latest released
> version?
> >>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
> >>>> >>
> >>>> >>> If you don't want to do that, then I think the latest docs need to
> >>>> contain
> >>>> >>> some sort of history on feature changes/upgrades.
> >>>> >>
> >>>> >> Hm... I think it's easier to keep few versions ;-)
> >>>> >>
> >>>> >>
> >>>> >> 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
> >>>>
> >>>>
> >>>
> >>>
> >>> --
> >>> Cheers,
> >>> Paul
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
>


-- 
Cheers,
Paul

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
I have removed custom css, the space looks better now :-)

https://cwiki.apache.org/confluence/display/WW/Home


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2013/12/16 Lukasz Lenart <lu...@apache.org>:
> FYI
>
> Confluence was upgraded to version 5 and there are some problems with
> editing pages.
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/12/11 Lukasz Lenart <lu...@apache.org>:
>> One more thing: everything editable will be moved to struts-site (i.e.
>> the new plugin.md) to don't mess with things generated by Maven
>>
>> So the project source code will contain only source code and JavaDocs,
>> the rest will be outside it.
>>
>>
>> Regards
>> --
>> Łukasz
>> + 48 606 323 122 http://www.lenart.org.pl/
>>
>> 2013/12/11 Paul Benedict <pb...@apache.org>:
>>> Sounds good to me. The easier the better.
>>>
>>>
>>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <lu...@apache.org>wrote:
>>>
>>>> Still thinking how to organise everything, maybe instead common
>>>> /release/2.3.x and so on it'd be better to have something like that:
>>>>
>>>> /docs/latest -> latest development version
>>>> /docs/2.3.x
>>>> /docs/2.2.x
>>>> ...
>>>>
>>>> and
>>>>
>>>> /apidocs/latest -> the same as above
>>>> /apidocs/2.3.x
>>>> /apidocs/2.2.x
>>>> ...
>>>>
>>>> there be no more dedicated S2 subsite, everything will be put on the
>>>> top, also Maven reports will be thrown away.
>>>>
>>>>
>>>> Regards
>>>> --
>>>> Łukasz
>>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>>
>>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>>> > Starting work on that - it must be resolved before next release comes
>>>> out.
>>>> >
>>>> > My plan is to have two tasks:
>>>> > 1. it will export pages from Confluence and will put them under /docs
>>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>>> >
>>>> > WDYT?
>>>> >
>>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>>> >
>>>> >
>>>> > Regards
>>>> > --
>>>> > Łukasz
>>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>>> >
>>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>>> >>> I usually find it a life-saver to see the docs of previous versions.
>>>> Not
>>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>>> features
>>>> >>> to what was before. I think we definitely need to keep the docs of the
>>>> >>> previously published versions around.
>>>> >>
>>>> >> But you meant to have the Draft docs and the latest released version?
>>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>>> >>
>>>> >>> If you don't want to do that, then I think the latest docs need to
>>>> contain
>>>> >>> some sort of history on feature changes/upgrades.
>>>> >>
>>>> >> Hm... I think it's easier to keep few versions ;-)
>>>> >>
>>>> >>
>>>> >> 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
>>>>
>>>>
>>>
>>>
>>> --
>>> Cheers,
>>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
FYI

Confluence was upgraded to version 5 and there are some problems with
editing pages.


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2013/12/11 Lukasz Lenart <lu...@apache.org>:
> One more thing: everything editable will be moved to struts-site (i.e.
> the new plugin.md) to don't mess with things generated by Maven
>
> So the project source code will contain only source code and JavaDocs,
> the rest will be outside it.
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/12/11 Paul Benedict <pb...@apache.org>:
>> Sounds good to me. The easier the better.
>>
>>
>> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <lu...@apache.org>wrote:
>>
>>> Still thinking how to organise everything, maybe instead common
>>> /release/2.3.x and so on it'd be better to have something like that:
>>>
>>> /docs/latest -> latest development version
>>> /docs/2.3.x
>>> /docs/2.2.x
>>> ...
>>>
>>> and
>>>
>>> /apidocs/latest -> the same as above
>>> /apidocs/2.3.x
>>> /apidocs/2.2.x
>>> ...
>>>
>>> there be no more dedicated S2 subsite, everything will be put on the
>>> top, also Maven reports will be thrown away.
>>>
>>>
>>> Regards
>>> --
>>> Łukasz
>>> + 48 606 323 122 http://www.lenart.org.pl/
>>>
>>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>>> > Starting work on that - it must be resolved before next release comes
>>> out.
>>> >
>>> > My plan is to have two tasks:
>>> > 1. it will export pages from Confluence and will put them under /docs
>>> > 2. used after release to update JavaDocs (regenerate from tag) and
>>> > Docs (copy from /docs to /release/2.3.x/docs)
>>> >
>>> > WDYT?
>>> >
>>> > https://issues.apache.org/jira/browse/INFRA-6350
>>> >
>>> >
>>> > Regards
>>> > --
>>> > Łukasz
>>> > + 48 606 323 122 http://www.lenart.org.pl/
>>> >
>>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>> >>> I usually find it a life-saver to see the docs of previous versions.
>>> Not
>>> >>> everyone upgrades and it's impossible to compare latest syntax and
>>> features
>>> >>> to what was before. I think we definitely need to keep the docs of the
>>> >>> previously published versions around.
>>> >>
>>> >> But you meant to have the Draft docs and the latest released version?
>>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>> >>
>>> >>> If you don't want to do that, then I think the latest docs need to
>>> contain
>>> >>> some sort of history on feature changes/upgrades.
>>> >>
>>> >> Hm... I think it's easier to keep few versions ;-)
>>> >>
>>> >>
>>> >> 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
>>>
>>>
>>
>>
>> --
>> Cheers,
>> Paul

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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
One more thing: everything editable will be moved to struts-site (i.e.
the new plugin.md) to don't mess with things generated by Maven

So the project source code will contain only source code and JavaDocs,
the rest will be outside it.


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2013/12/11 Paul Benedict <pb...@apache.org>:
> Sounds good to me. The easier the better.
>
>
> On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <lu...@apache.org>wrote:
>
>> Still thinking how to organise everything, maybe instead common
>> /release/2.3.x and so on it'd be better to have something like that:
>>
>> /docs/latest -> latest development version
>> /docs/2.3.x
>> /docs/2.2.x
>> ...
>>
>> and
>>
>> /apidocs/latest -> the same as above
>> /apidocs/2.3.x
>> /apidocs/2.2.x
>> ...
>>
>> there be no more dedicated S2 subsite, everything will be put on the
>> top, also Maven reports will be thrown away.
>>
>>
>> Regards
>> --
>> Łukasz
>> + 48 606 323 122 http://www.lenart.org.pl/
>>
>> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
>> > Starting work on that - it must be resolved before next release comes
>> out.
>> >
>> > My plan is to have two tasks:
>> > 1. it will export pages from Confluence and will put them under /docs
>> > 2. used after release to update JavaDocs (regenerate from tag) and
>> > Docs (copy from /docs to /release/2.3.x/docs)
>> >
>> > WDYT?
>> >
>> > https://issues.apache.org/jira/browse/INFRA-6350
>> >
>> >
>> > Regards
>> > --
>> > Łukasz
>> > + 48 606 323 122 http://www.lenart.org.pl/
>> >
>> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
>> >>> I usually find it a life-saver to see the docs of previous versions.
>> Not
>> >>> everyone upgrades and it's impossible to compare latest syntax and
>> features
>> >>> to what was before. I think we definitely need to keep the docs of the
>> >>> previously published versions around.
>> >>
>> >> But you meant to have the Draft docs and the latest released version?
>> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>> >>
>> >>> If you don't want to do that, then I think the latest docs need to
>> contain
>> >>> some sort of history on feature changes/upgrades.
>> >>
>> >> Hm... I think it's easier to keep few versions ;-)
>> >>
>> >>
>> >> 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
>>
>>
>
>
> --
> Cheers,
> Paul

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

Re: Re-organise docs

Posted by Paul Benedict <pb...@apache.org>.
Sounds good to me. The easier the better.


On Wed, Dec 11, 2013 at 2:06 AM, Lukasz Lenart <lu...@apache.org>wrote:

> Still thinking how to organise everything, maybe instead common
> /release/2.3.x and so on it'd be better to have something like that:
>
> /docs/latest -> latest development version
> /docs/2.3.x
> /docs/2.2.x
> ...
>
> and
>
> /apidocs/latest -> the same as above
> /apidocs/2.3.x
> /apidocs/2.2.x
> ...
>
> there be no more dedicated S2 subsite, everything will be put on the
> top, also Maven reports will be thrown away.
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/12/10 Lukasz Lenart <lu...@apache.org>:
> > Starting work on that - it must be resolved before next release comes
> out.
> >
> > My plan is to have two tasks:
> > 1. it will export pages from Confluence and will put them under /docs
> > 2. used after release to update JavaDocs (regenerate from tag) and
> > Docs (copy from /docs to /release/2.3.x/docs)
> >
> > WDYT?
> >
> > https://issues.apache.org/jira/browse/INFRA-6350
> >
> >
> > Regards
> > --
> > Łukasz
> > + 48 606 323 122 http://www.lenart.org.pl/
> >
> > 2013/11/6 Lukasz Lenart <lu...@apache.org>:
> >> 2013/11/5 Paul Benedict <pb...@apache.org>:
> >>> I usually find it a life-saver to see the docs of previous versions.
> Not
> >>> everyone upgrades and it's impossible to compare latest syntax and
> features
> >>> to what was before. I think we definitely need to keep the docs of the
> >>> previously published versions around.
> >>
> >> But you meant to have the Draft docs and the latest released version?
> >> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
> >>
> >>> If you don't want to do that, then I think the latest docs need to
> contain
> >>> some sort of history on feature changes/upgrades.
> >>
> >> Hm... I think it's easier to keep few versions ;-)
> >>
> >>
> >> 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
>
>


-- 
Cheers,
Paul

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
Still thinking how to organise everything, maybe instead common
/release/2.3.x and so on it'd be better to have something like that:

/docs/latest -> latest development version
/docs/2.3.x
/docs/2.2.x
...

and

/apidocs/latest -> the same as above
/apidocs/2.3.x
/apidocs/2.2.x
...

there be no more dedicated S2 subsite, everything will be put on the
top, also Maven reports will be thrown away.


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2013/12/10 Lukasz Lenart <lu...@apache.org>:
> Starting work on that - it must be resolved before next release comes out.
>
> My plan is to have two tasks:
> 1. it will export pages from Confluence and will put them under /docs
> 2. used after release to update JavaDocs (regenerate from tag) and
> Docs (copy from /docs to /release/2.3.x/docs)
>
> WDYT?
>
> https://issues.apache.org/jira/browse/INFRA-6350
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/11/6 Lukasz Lenart <lu...@apache.org>:
>> 2013/11/5 Paul Benedict <pb...@apache.org>:
>>> I usually find it a life-saver to see the docs of previous versions. Not
>>> everyone upgrades and it's impossible to compare latest syntax and features
>>> to what was before. I think we definitely need to keep the docs of the
>>> previously published versions around.
>>
>> But you meant to have the Draft docs and the latest released version?
>> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>>
>>> If you don't want to do that, then I think the latest docs need to contain
>>> some sort of history on feature changes/upgrades.
>>
>> Hm... I think it's easier to keep few versions ;-)
>>
>>
>> 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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
Starting work on that - it must be resolved before next release comes out.

My plan is to have two tasks:
1. it will export pages from Confluence and will put them under /docs
2. used after release to update JavaDocs (regenerate from tag) and
Docs (copy from /docs to /release/2.3.x/docs)

WDYT?

https://issues.apache.org/jira/browse/INFRA-6350


Regards
-- 
Łukasz
+ 48 606 323 122 http://www.lenart.org.pl/

2013/11/6 Lukasz Lenart <lu...@apache.org>:
> 2013/11/5 Paul Benedict <pb...@apache.org>:
>> I usually find it a life-saver to see the docs of previous versions. Not
>> everyone upgrades and it's impossible to compare latest syntax and features
>> to what was before. I think we definitely need to keep the docs of the
>> previously published versions around.
>
> But you meant to have the Draft docs and the latest released version?
> Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?
>
>> If you don't want to do that, then I think the latest docs need to contain
>> some sort of history on feature changes/upgrades.
>
> Hm... I think it's easier to keep few versions ;-)
>
>
> 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

Re: Re-organise docs

Posted by Lukasz Lenart <lu...@apache.org>.
2013/11/5 Paul Benedict <pb...@apache.org>:
> I usually find it a life-saver to see the docs of previous versions. Not
> everyone upgrades and it's impossible to compare latest syntax and features
> to what was before. I think we definitely need to keep the docs of the
> previously published versions around.

But you meant to have the Draft docs and the latest released version?
Or as it is now, version per branch (2.3, 2.2, 2.1, etc) ?

> If you don't want to do that, then I think the latest docs need to contain
> some sort of history on feature changes/upgrades.

Hm... I think it's easier to keep few versions ;-)


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

Re: Re-organise docs

Posted by Paul Benedict <pb...@apache.org>.
I usually find it a life-saver to see the docs of previous versions. Not
everyone upgrades and it's impossible to compare latest syntax and features
to what was before. I think we definitely need to keep the docs of the
previously published versions around.

If you don't want to do that, then I think the latest docs need to contain
some sort of history on feature changes/upgrades.


On Tue, Nov 5, 2013 at 1:34 AM, Lukasz Lenart <lu...@apache.org>wrote:

> I'm wondering what is wrong with exposing only the latest Draft docs
> and just forget about publishing docs on each release? Thus will
> simplify keeping page update-2-date and reduce amount of time spend on
> preparing new release.
>
>
> Regards
> --
> Łukasz
> + 48 606 323 122 http://www.lenart.org.pl/
>
> 2013/10/30 Lukasz Lenart <lu...@apache.org>:
> > There is one problem - to include docs in the assemblies they must be
> > downloaded with wget (there is no support for SiteExporter in
> > Jenkins).
> > So, I must add a task which will export docs from Confluence and put
> > them under /docs and then with wget they can be downloaded to Jenkins
> > and assembled :\
> >
> > ech... bit messy solution, but I don't see other option.
> >
> >
> > Regards
> > --
> > Łukasz
> > + 48 606 323 122 http://www.lenart.org.pl/
> >
> > 2013/9/10  <um...@gmail.com>:
> >> +1 for that
> >> It will reduce a lot of confusion
> >> ------Original Message------
> >> From: Lukasz Lenart
> >> To: Struts Developers List
> >> ReplyTo: Struts Developers List
> >> Subject: Re-organise docs
> >> Sent: Sep 10, 2013 12:18 PM
> >>
> >> Hi,
> >>
> >> I thought a bit about our docs - for each main branch we provide docs,
> >> i.e. /release/2.3.x/, /release/2.2.x/ etc. We also expose draft docs
> >> as /development/2.x - all thus leads to mess when we must update
> >> something or so.
> >>
> >> So maybe just instead of many places with docs we should expose the
> >> latest related to last release under path /docs and redirect to
> >> Confluence in case of draft docs?
> >>
> >>
> >> 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
> >>
> >>
> >>
> >> Sent from BlackBerry® on Airtel
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
>


-- 
Cheers,
Paul