struts-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Lukasz Lenart <lukaszlen...@apache.org>
Subject Re: Re-organise docs
Date Thu, 13 Feb 2014 06:41:04 GMT
I assume no objections and I can switch the branch.

2014-02-09 22:21 GMT+01:00 Lukasz Lenart <lukaszlenart@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 <lukaszlenart@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 <lukaszlenart@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 <lukaszlenart@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 <lukaszlenart@apache.org>:
>>>>> I don't see objections so I think we can start with that :-)
>>>>>
>>>>> 2014/1/9 Lukasz Lenart <lukaszlenart@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 <pbenedict@apache.org>:
>>>>>>> Years in the making. WOW! The Wiki documentation finally looks
readable!
>>>>>>>
>>>>>>>
>>>>>>> On Mon, Dec 16, 2013 at 3:33 PM, Lukasz Lenart <lukaszlenart@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 <lukaszlenart@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 <lukaszlenart@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 <pbenedict@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 <lukaszlenart@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 <lukaszlenart@apache.org>:
>>>>>>>> >>>> >> 2013/11/5 Paul Benedict <pbenedict@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


Mime
View raw message